架构设计

Canonical source: .qoder/repowiki/knowledge/zh/NeKiro Console 前端工程根 (React + Vite)/架构设计.md. This page is rendered from the Console-owned RepoWiki document and retains its canonical source language.

单页 Web 应用根目录，入口为 index.html 挂载 #root，由 /src/main.tsx 作为 React 应用启动点；构建与开发由 Vite 6 驱动，启用 @vitejs/plugin-react 与 @tailwindcss/vite 插件，并通过 tsconfig.json 的 paths 将 @/* 映射到项目根，配合 vite.config.ts 中的 alias 实现统一路径解析。运行时依赖 Express（可能用于本地代理或 AI Studio 内嵌服务）、dotenv 注入环境变量，并集成 @google/genai 调用 Gemini API；motion 库用于动画效果。metadata.json 声明该应用在 AI Studio 中的元数据与能力标识（MAJOR_CAPABILITY_SERVER_SIDE_GEMINI_API），.env.example 定义了 GEMINI_API_KEY、APP_URL 以及以 VITE_ 前缀暴露给客户端的 NeKiro Control Plane 北向 API 地址、token、owner 与默认 workspace 等配置项。