2995840376 0ce191c448 chore: 初始化 iotsaas 版本库基线
纳入范围:
- backend/  Spring Boot 多模块后端(iot-common/device/rule/data/alarm/auth)
- frontend/admin/  Vue3 + Element Plus 管理后台
- Android/   涂鸦原生 APP (com.xhai.iot)
- backend/sql/  Flyway 风格迁移脚本(V2~V21)
- docs/       对接文档与设计文档

排除范围:
- 构建产物: node_modules/ target/ build/ dist/ .gradle/
- 签名密钥: *.jks *.keystore (严禁入库)
- 本机配置: Android/local.properties
- 运行日志: logs/ *.log
- AI 协作本地数据 .codebuddy/ 与第三方 demo tuya-demo/

.gitattributes 统一以 LF 存储, Windows 批处理保留 CRLF
2026-10-27 12:00:41 +08:00

2.3 KiB

figma-make-app

React + Vite + Tailwind CSS project running inside Figma Make.

Development Server

A Vite development server is already running on $PORT (default 8443). You don't need to start it manually.

  • Preview URL: The user can access the running app through the preview panel
  • Hot reload: Changes to source files are reflected immediately

Project Structure

This is the canonical project structure. Start with task-relevant files below. Only follow imports or inspect other files when required, when a documented path is missing, or when the repository contradicts this guide.

  • src/main.tsx - React entrypoint; imports src/index.css and mounts src/App.tsx into the #root element
  • src/App.tsx - Primary application component and the usual starting point for UI work
  • src/index.css - Global CSS entrypoint and Tailwind CSS v4 import
  • index.html - Vite HTML shell containing the #root element and loading src/main.tsx
  • package.json - Project dependencies and the Vite build, development, preview, and formatting scripts
  • vite.config.ts - Vite configuration with React, Tailwind CSS v4, and Figma Make plugins plus the @ alias for src
  • .mise.toml - Toolchain versions for Node.js and pnpm

Dependencies

  • Runtime: React 19 and React DOM 19
  • Styling: Tailwind CSS v4 with the @tailwindcss/vite plugin
  • Build tooling: Vite 8, TypeScript 5.7, and @vitejs/plugin-react
  • Formatting: oxfmt

Styling

This project uses Tailwind CSS v4 through the @tailwindcss/vite plugin configured in vite.config.ts. src/index.css imports Tailwind with @import 'tailwindcss';. Use Tailwind utility classes directly in JSX and put global CSS or Tailwind v4 theme customization in src/index.css. This scaffold does not need a Tailwind config file or PostCSS config.

src/main.tsx imports src/index.css, so global font wiring belongs in src/index.css. Keep CSS @import statements first, then add any @font-face rules and font-family defaults there.

Code quality

  • Use double quotes for strings containing apostrophes ("We're here to help"), or escape them in single-quoted strings. An unescaped apostrophe in a single-quoted string breaks the build.
  • Ensure JSX tags are closed and braces are balanced.
  • Export components as default exports.