Starbase 是一个生产就绪的静态网站样板,采用 Webpack 5、TypeScript、PostCSS 和 Tailwind CSS,旨在与 Vercel、Netlify 和 AWS Amplify 等现代 Jamstack 托管提供商集成。利用 2024 年可用的一些最强大的前端技术,在几分钟内开始构建,并由令人愉悦的简单且功能齐全的开发人员体验提供支持。
Starbase 由 Brian Staruk 创建,作为个人代码风格指南和灵活的项目样板。这是一项持续进行中的工作,自 2017 年初以来一直在持续维护,重点是实施最新的行业标准并使所有依赖项保持最新。
“简单是最终的复杂。”
——列奥纳多·达·芬奇
Starbase 的首要任务是变得极其简单;易于配置、扩展和集成。这也使其成为 Web 开发人员增强裸机 Webpack 配置、TypeScript 和/或 Tailwind CSS 知识的绝佳平台。
首先,运行以下命令,该命令将指导您完成安装过程:
npx starbase@latest
建议使用 nvm (或 nvm-windows)来管理 Node 版本安装。如果您不使用 nvm,则需要参考/.nvmrc
文件来验证您的 Node 版本是否与推荐版本兼容。
首先确保您正在运行推荐版本的 Node,并安装项目依赖项:
nvm use
npm install
dev
命令将在 http://localhost:3000 处提供项目源。 /src
中所做的任何更改都将重新编译源代码并刷新您的 Web 浏览器。
npm run dev
build
命令会将项目源代码编译并缩小到/dist
中以进行集成或部署。
npm run build
Starbase 设置为部署到 Vercel、Netlify 等托管环境中 Web 服务器的根目录。因此,所有资产(js、css、字体、图像等)均通过绝对路径引用。
如果您想通过相对路径引用资源,以便可以在 Web 浏览器中分发和打开编译后的.html
文件,而无需部署到托管环境,则需要删除(或注释掉) /webpack/webpack.config.base.ts
中的publicPath
/webpack/webpack.config.base.ts
。
如果您想保留绝对路径,但将其设置为子目录而不是根目录,则可以更改该值而不是删除它。
Starbase 是免费的开源软件。请用它构建很棒的东西。下次你在波士顿时,你可以给我买瓶啤酒,给这个项目加星标,然后告诉朋友,或者你也可以擦掉所有来源标志,告诉你的同事,这是你自己做的。一切都好!