README

这是一个为 TILT 构建的站点的 Craft CMS v5.X 启动设置。它在一定程度上具有观点性，因为它已配置为使用以下堆栈：

DDEV 作为本地开发服务器
Vite 用于处理 HMR 和前端构建功能
SASS/PostCSS 用于 CSS 处理
Alpine JS 用于 JavaScript

安装说明

仅当您正在创建新项目时执行此操作。只有当您是启动构建过程的人时，才需要安装样板文件。如果不是， whoever did 初始化它应该在 Tilt 的 GitHub 账户上为新的网站创建了一个存储库。简单克隆该存储库，然后创建一个空数据库，并在项目文件夹内运行 composer update 命令，然后运行 ./craft install 命令。

下载文件

首先，您需要运行命令以下载软件包文件。打开终端并转到您保存所有网站的地方。一旦到了那里，运行以下命令

composer create-project tiltbuilt/boilermaker-tr my/project/path --no-install

其中项目路径部分用您要创建的项目文件夹名称替换（通常是客户网站的名称，全部小写，无空格。连字符和下划线是允许的）。文件夹必须是空的。

配置 DDEV

**不要跳过此步骤** 如果您想将您的网站运行在其他域名上而不是 https://craftcms.ddev.site，则运行

ddev config

使用以下设置

项目名称：例如，mysite 将导致项目 URL 为 https://mysite.ddev.site（您稍后会需要此信息） Docroot 位置：保持不变，web 是默认值项目类型：保持不变，php 是默认值

安装 Craft

要安装干净的 Craft 版本，请运行

make install

按照提示操作。

此命令将

将您的本地 SSH 密钥复制到容器中（如果您正在设置 craft-scripts，这将很有用）
启动您的 DDEV 项目
安装 Composer
安装 npm
一次性构建 Vite
生成 APP_ID 并保存到您的 .env 文件中
生成 SECURITY_KEY 并保存到您的 .env 文件中
首次安装 Craft，允许您设置管理员的账户凭证
安装所有 Craft 插件

过程完成后，键入 ddev launch 以在您的默认浏览器中打开项目。 🚀

使用 Vite 进行本地开发

要开始使用 Vite 开发服务器和 HMR 进行开发，请运行

make dev

此命令将

将您的本地 SSH 密钥复制到容器中（如果您正在设置 craft-scripts，这将很有用）
启动您的 DDEV 项目
安装 Composer
安装 npm
一次性构建 Vite
启动 Vite 开发服务器

在浏览器中打开您的项目域名以验证 Vite 已连接。开始制作美丽的东西。

Makefile

Makefile 已包含，以提供对常见开发命令的统一 CLI。

make install - 运行一次完整过程，以设置项目并安装 Craft。
make up - 启动 DDEV 项目，确保已添加 SSH 密钥，并已安装 npm 和 Composer。
make dev - 一次性构建所有前端资源，然后启动 Vite 的服务器以进行 HMR。
make build - 构建所有前端资源。
make pull - 拉取远程数据库和资源（需要设置 craft-scripts

重要提示 - 在运行安装程序之前，请确保将您的 .npmrc 文件复制到项目中，否则 npm install 步骤将失败，因为它会尝试安装 GSAP 的付费套件，这需要认证。

Craft CMS 插件

Tailwind 插件

JavaScript 库

致谢

本项目基于许多人的工作，包括 Craft CMS 的整个团队、NY Studio 107 的 Andrew Welch、CraftQuest 的 Ryan Irelan、One Darnley Road 的团队以及其他人。衷心感谢大家的辛勤工作和愿意与社区分享的热情。没有大家的见解和示例，我无法完成这个项目。我还想感谢 TILT 团队对项目的持续支持和致力于打造优秀网站的热情。感谢大家！

tiltbuilt / boilermaker-tr

维护者

详细信息