From bfe5541e56f68b74fd41974c804f8e7ac1ff9f2a Mon Sep 17 00:00:00 2001 From: shu Date: Thu, 22 Oct 2026 13:03:06 +0800 Subject: feat: 初始化 Astryx React 应用模板 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 基于 Vite 8、React 19、TypeScript 6、React Router 7 和 Astryx 0.7.2 搭建完整的中文应用起始模板，包含可直接运行的应用外壳与示例页面。 主要变更： - 使用 Astryx 构建 AppShell、顶部导航、可折叠侧边栏和响应式移动端抽屉。 - 接入 Astryx neutral 主题与中文语言包，支持明暗主题切换并持久化偏好。 - 新增概览、组件、图标、关于和 404 页面，统一使用共享页面框架。 - 将页面路由、侧边栏名称、图标和active状态合并到 app-routes.tsx， 路由与导航由同一份配置生成，避免重复维护。 - 新增根目录 app.config.ts，可在 browser/history 与 hash 路由模式之间切换； 当前保留 hash 模式配置。 - 组件页提供 14 个可交互组合场景，覆盖全部 173 个 Astryx 组件， 包含按钮、表单、表格、导航、聊天、对话框、菜单、命令面板和 Toast 等。 - 新增图标页面，支持浏览 29 个 Astryx 语义图标和 1903 个 Lucide 图标， 提供搜索、分页、图标集切换和点击复制用法。 - 对组件页和图标页实施路由级懒加载，并按 React、React Router 拆分 vendor chunk，降低首屏入口体积并改善长期缓存。 - 接入 React Router 的 LinkProvider，保证 Astryx 链接、导航和按钮在两种 路由模式下均使用客户端导航。 - 配置 pnpm 供应链策略例外与依赖构建许可，锁定可以正常安装的依赖版本。 - 补充 README，记录项目结构、脚本、组件展厅、图标页、路由模式与构建策略。 验证结果： - pnpm build 通过 - pnpm lint 0 warnings - browser 与 hash 两种路由模式的页面和侧边栏导航均已验证 --- AGENTS.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 AGENTS.md (limited to 'AGENTS.md') diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..42f57eb --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,33 @@ +# AGENTS.md + +Project-specific guidance for AI coding agents. + + +Astryx v0.7.2 · 173 components +CLI: run every command as `npx astryx ` (shown below as `astryx ...`). + +SETUP (once, in app entry e.g. main.tsx) — without these, components render unstyled: + import "@astryxdesign/core/reset.css"; + import "@astryxdesign/core/astryx.css"; + +WORKFLOW — start every page from a template, never from scratch: +1. `astryx build ""` — names the template to scaffold from and the parts it lacks. +2. `astryx template ` — scaffold it; keep its frame, gap and padding; replace the content. +3. `astryx template ` for parts it lacks; `astryx component ` to read props before using one. +Changing an existing page? Keep it: skip step 2 and add blocks/components inside its sections. + +RULES: +- No
— components handle all layout and spacing. +- Read `astryx docs layout` before changing a template's frame. +- Dense data = rows (Table, List/Item), not Card-wrapped lists. Badge = counts only. +- Style with component props first, then tokens (var(--color-*|--spacing-*|--radius-*)). No raw hex/px. No StyleX/Tailwind compiler here — don't use xstyle/utility classes directly. Some templates use StyleX and need a compiler plugin; see `astryx docs styling-overview`. +- Palettes and custom colors go through the theme, never :root overrides. Run `astryx theme add ` to import; `theme eject ` only forks source. See `astryx docs theme`. +- SELF-CHECK: re-read the file; replace any raw
/, imported .css/@apply, or hardcoded #hex/px with the component or a token. + +`astryx help` lists every command. Key ones beyond the workflow: + search "" find any component / hook / doc / template + discover integrations you could add + docs getting-started, principles, tokens, theme … (`astryx docs` lists all) + docs cli commands, API reference, integration authoring + upgrade --from --apply run after a dependency bump + -- cgit v1.2.3