agilelabs-fx-docs main samples/tutorials/frontend-starter/README.md

frontend-starter

这是前端初始化主线的最终样例目录。它保持“最新可运行状态”,教程正文会按步骤说明当前应关注哪些文件和命令。

适合什么时候看

  • 想确认前端初始化主线最终会落成什么目录结构。
  • 想快速定位 package.jsonvite.config.tssrc/main.tssrc/app.css 的职责边界。
  • 想先看一套可运行的前端样例,再回到教程逐步理解每一段配置。

服务哪些教程

当前目录约定

  • .npmrc:项目级 npm 源,指向 https://npm.feinian.net
  • package.json:前端依赖与运行脚本。
  • vite.config.ts:本地开发端口、代理与构建产物目录。
  • src/main.ts:主题切换、API 调用和页面骨架。
  • src/app.css:Tailwind v4 与 Font Awesome Free v7 的入口。
  • dist/node_modules/.vite/:本地安装和构建时会生成,但不属于仓库维护内容。

运行方式

pnpm install
pnpm dev
  • 默认开发端口由 vite.config.ts 统一定义。
  • 构建命令为 pnpm build,产物目录固定为 dist/
  • 默认通过 /api/demo/hello 对接后端样例,适合和 backend-starter 联调。

当前最终状态

  • 可以通过 pnpm install 安装依赖。
  • 可以通过 pnpm dev 在本地启动。
  • 默认支持 light/dark 双主题。
  • 默认通过 /api/demo/hello 访问后端样例接口。

相关页面