模板和技术栈

刚开始使用 Remix 吗？最新版本的 Remix 现在是 React Router v7。如果你想使用最新的框架特性，你应该使用 React Router 模板创建你的项目。

当使用 create-remix 生成新项目时，你可以选择模板或技术栈来快速启动并运行。模板是让你快速启动并运行的最小起点。“技术栈”是更完整的模板，更接近生产就绪的架构（可能包括测试、数据库、CI 和部署配置等方面）。

模板

如果你运行 create-remix 时没有提供 --template 选项，你将获得一个使用 Remix 应用服务器的基本模板。

npx create-remix@latest

如果你对使用 TypeScript 不感兴趣，你可以安装更简单的 JavaScript 模板。

npx create-remix@latest --template remix-run/remix/templates/remix-javascript

如果你只是想第一次尝试 Remix，这是一个很好的起点。你可以随时自己扩展这个起点，或者稍后迁移到更高级的模板。

官方模板

如果你想更好地控制你的服务器，或者希望部署到非 node 运行时（如 Arc、Cloudflare 或 Deno），那么你可以尝试我们 Remix 仓库中的官方模板之一。

npx create-remix@latest --template remix-run/remix/templates/cloudflare
npx create-remix@latest --template remix-run/remix/templates/cloudflare-workers
npx create-remix@latest --template remix-run/remix/templates/express
npx create-remix@latest --template remix-run/remix/templates/remix
npx create-remix@latest --template remix-run/remix/templates/remix-javascript

## SPA Mode
npx create-remix@latest --template remix-run/remix/templates/spa

## Classic Remix Compiler
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/arc
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/cloudflare-pages
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/cloudflare-workers
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/deno
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/express
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/fly
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/remix
npx create-remix@latest --template remix-run/remix/templates/classic-remix-compiler/remix-javascript

第三方模板

一些托管提供商维护他们自己的 Remix 模板。有关更多信息，请参阅下面列出的官方集成指南。

示例

我们还提供了一个社区驱动的示例仓库，每个示例都展示了不同的 Remix 功能、模式、工具、托管提供商等。你可以使用这些示例，以类似的方式安装工作示例。

npx create-remix@latest --template remix-run/examples/basic

技术栈

当一个模板更接近于一个生产就绪的应用程序时，以至于它提供了关于 CI/CD 管道、数据库和托管平台的意见时，Remix 社区将这些模板称为“技术栈”。

有几个官方提供的技术栈，但你也可以自己创建（阅读下面的更多内容）。

阅读功能发布博客文章并在 YouTube 上观看 Remix 技术栈视频。

官方技术栈

官方技术栈提供了生产应用程序所需的常见功能，包括

数据库
自动部署管道
身份验证
测试
代码检查/格式化/TypeScript

你所剩下的是一切都已完全设置好，你可以开始使用 Remix 构建任何你想要的精彩 Web 体验。以下是官方技术栈

Blues Stack：部署到边缘（分布式），使用长时间运行的 Node.js 服务器和 PostgreSQL 数据库。适用于服务数百万用户的大型快速生产级应用程序。
Indie Stack：部署到带有持久 SQLite 数据库的长时间运行的 Node.js 服务器。此技术栈非常适合具有你控制的动态数据的网站（博客、营销、内容网站）。它也是 MVP、原型和概念验证的完美、低复杂性引导，可以稍后轻松更新到 Blues 技术栈。
Grunge Stack：部署到运行 Node.js 的无服务器函数，并使用 DynamoDB 进行持久化。适用于希望在 AWS 基础设施上部署为数百万用户提供服务的生产级应用程序的人。

你可以通过在运行 create-remix 时提供 --template 选项来使用这些技术栈，例如

npx create-remix@latest --template remix-run/blues-stack

是的，它们是以音乐流派命名的。🤘 继续摇滚。

社区技术栈

你可以在 GitHub 上浏览社区技术栈列表。

可以通过将 GitHub 用户名/仓库组合传递给运行 create-remix 时的 --template 选项来使用社区技术栈，例如

npx create-remix@latest --template :username/:repo

如果你想与社区分享你的技术栈，请不要忘记用 remix-stack 主题标记它，以便其他人可以找到它 —— 是的，我们确实建议你以音乐子流派（不是“摇滚”而是“独立”）来命名你的技术栈！

其他信息

私有模板

如果你的模板在私有的 GitHub 仓库中，你可以通过 --token 选项传递 GitHub 令牌。

npx create-remix@latest --template your-private/repo --token yourtoken

该令牌只需要 repo 访问权限。

本地模板

你可以将本地目录或磁盘上的 tarball 提供给 --template 选项，例如

npx create-remix@latest --template /my/remix-stack
npx create-remix@latest --template /my/remix-stack.tar.gz
npx create-remix@latest --template /my/remix-stack.tgz
npx create-remix@latest --template file:///Users/michael/my-remix-stack.tar.gz

自定义模板提示

依赖版本

如果你在 package.json 中将任何依赖项设置为 *，Remix CLI 会将其更改为已安装的 Remix 版本的 semver caret。

-   "remix": "*",
+   "remix": "^2.0.0",

这允许你无需定期将你的模板更新到该特定软件包的最新版本。当然，如果你希望手动管理该软件包的版本，则不必使用 *。

自定义初始化

如果模板在根目录有一个 remix.init/index.js 文件，那么该文件将在项目生成且依赖项安装完成后执行。这使你有机会在模板初始化过程中执行任何你想要的操作。例如，在 blues stack 中，app 属性必须是全局唯一的，因此我们使用 remix.init/index.js 文件将其更改为为项目创建的目录的名称 + 几个随机字符。

你甚至可以使用 remix.init/index.js 向开发人员询问更多问题以进行额外配置（使用像 inquirer 这样的工具）。有时，你需要安装依赖项才能执行此操作，但这些依赖项仅在初始化期间有用。在这种情况下，你还可以创建一个带有依赖项的 remix.init/package.json，Remix CLI 将在运行你的脚本之前安装这些依赖项。

在 init 脚本运行后，remix.init 文件夹会被删除，因此你无需担心它会使完成的代码库混乱。

请注意，消费者可以选择不运行 remix.init 脚本。要手动执行此操作，他们需要运行 remix init。