garciaj42/avarice

terrario

镜像概述

terrario是一个基于Create React App构建的桌游应用，提供便捷的Docker化本地开发环境，支持代码变更自动监听与重新编译，适用于桌游应用的开发与测试。

核心功能与特性

• Docker化部署：通过docker-compose实现一键启动开发环境，无需本地配置Node/Yarn
• 自动热重载：启动后持续监听前端代码变化并自动重新编译
• 标准React开发工具链：基于Create React App，提供完整的开发、测试和构建流程
• 便捷清理：支持一键清除容器和卷，保持开发环境整洁

使用场景

• 桌游应用的本地开发与调试
• 前端代码的实时预览与测试
• 无需本地配置Node环境即可快速参与项目开发

使用方法

本地部署

启动开发环境

通过以下命令启动包含自动代码监听的开发环境：

sh
docker-compose up --build

启动后，应用将在http://localhost:3000可用，且会自动监听代码变更并重新编译。

清理环境

完成开发后，可通过以下命令清理容器和卷：

sh
docker-compose down -v

可用脚本

在项目目录中，可运行以下脚本（需进入容器或本地配置Node环境）：

yarn start

以开发模式运行应用。在浏览器中打开http://localhost:3000查看。代码修改后页面会自动重新加载，控制台会显示 lint 错误。

yarn test

启动交互式监视模式的测试运行器。有关更多信息，请参阅https://***.github.io/create-react-app/docs/running-tests部分。

yarn build

将应用构建到build文件夹用于生产环境。它会正确捆绑生产模式下的React，并优化构建以获得最佳性能。构建会被压缩，文件名包含哈希值，应用已准备好部署。有关更多信息，请参阅https://***.github.io/create-react-app/docs/deployment部分。

yarn eject

注意：这是单向操作。一旦执行eject，就无法恢复！

如果对构建工具和配置选择不满意，可随时执行eject。此命令将从项目中移除单个构建依赖项，转而将所有配置文件和传递依赖项（Webpack、Babel、ESLint等）复制到项目中，以便完全控制它们。除eject外的所有命令仍可使用，但会指向复制的脚本，以便进行调整。

学习资源

• https://***.github.io/create-react-app/docs/getting-started
• React 文档

更多主题

• 代码分割：https://***.github.io/create-react-app/docs/code-splitting
• 分析包大小：https://***.github.io/create-react-app/docs/analyzing-the-bundle-size
• 创建渐进式Web应用：https://***.github.io/create-react-app/docs/making-a-progressive-web-app
• 高级配置：https://***.github.io/create-react-app/docs/advanced-configuration
• 部署：https://***.github.io/create-react-app/docs/deployment
• yarn build 无法压缩：https://***.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify