SuperAPI AI 工具集

webapp

前端与建站

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能面向使用预置模板构建全栈 Web 应用,技术栈为 Express + Vite + React + Tailwind CSS + shadcn/ui + Drizzle ORM。

主要能力与用法:先复制模板并安装依赖:cp -r skills/webapp/template/ <project-name>/,cd <project-name>,npm install;用 npm run dev 启动开发服务器,Express 后端与 Vite 前端共用同一端口。构建顺序为:先在 shared/schema.ts 定义数据模型,再写前端 React 组件与页面,然后在 server/routes.ts 实现 Express 路由,最后通过 queryClient 完成前后端集成。架构上尽量把逻辑放在前端,后端只负责数据持久化与 API 调用,并尽量减少文件数量。

关键限制:禁止使用 localStorage、sessionStorage、indexedDB 或 cookies,它们在沙箱 iframe 中被阻止;瞬时数据用 React state 或 context,持久数据用后端 API 与内存存储。路由必须使用 wouter 的 useHashLocation,否则部署后路由会失效;不要用 href="#section" 锚点导航。所有 HTTP 请求使用 @/lib/queryClient 的 apiRequest,不要用原生 fetch。Tailwind 为 v3,不要使用 v4 的 @import "tailwindcss" 或 @theme 语法。不要修改 Vite 与 drizzle 配置,除非绝对必要。

适用场景:SaaS、仪表盘、电商、品牌体验、管理后台等全栈应用。测试可参考 Playwright 交互文档;部署时静态应用执行 npm run build,含后端的应用构建后用 node dist/index.cjs 做生产验证。环境与预装包详见 skills/webapp/references/environment.md。