rafaelkallis/rafaelkallis.com

rafaelkallis/rafaelkallis.com 镜像文档

镜像概述

本镜像为基于Create React App的开源网站项目，旨在提供快速开发React应用的基础环境，包含完整的开发、测试、构建及部署流程，支持现代JavaScript特性与React生态工具链。

核心功能

1. 开发模式：通过npm start启动本地开发服务器，支持热重载与实时错误反馈。
2. 测试支持：npm test启动交互式测试运行器，覆盖组件测试与代码质量检查。
3. 生产构建：npm run build生成优化后的生产级静态资源，包含代码压缩与哈希文件名。
4. 配置自定义：npm run eject可导出完整配置文件，支持深度定制Webpack、Babel等工具链。
5. 特性支持：兼容ES6+语法、JSX、代码分割、CSS预处理（Sass/Less）等现代前端技术。

使用场景

• 个人或团队快速搭建React应用原型。
• 学习React开发流程与Create React App工具链。
• 部署静态React网站至各类平台（如GitHub Pages、Netlify等）。

配置说明

文件夹结构

项目遵循Create React App标准结构：

my-app/
  public/          # 静态资源与HTML模板
  src/             # 源代码目录（JS/JSX、CSS、组件等）
  package.json     # 依赖与脚本配置

常用命令

• 启动开发服务器：npm start（访问http://localhost:3000）
• 运行测试：npm test
• 构建生产包：npm run build
• 导出配置：npm run eject（不可逆操作）

Docker部署示例

单容器运行

bash
docker run -d -p 3000:3000 --name react-app rafaelkallis/rafaelkallis.com npm start

Docker Compose配置

yaml
version: '3'
services:
  react-app:
    image: rafaelkallis/rafaelkallis.com
    ports:
      - "3000:3000"
    command: npm start

注意事项

• 生产环境建议使用npm run build生成静态文件后，通过Nginx等静态服务器部署。
• 如需自定义环境变量，可通过.env文件或Docker环境变量注入。