Skip to content

AGENTS.md

Latest commit

 

History

History
48 lines (29 loc) · 2.33 KB

AGENTS.md

File metadata and controls

48 lines (29 loc) · 2.33 KB
Raw

Using Vite+, the Unified Toolchain for the Web

This project is using Vite+, a unified toolchain built on top of Vite, Rolldown, Vitest, tsdown, Oxlint, Oxfmt, and Vite Task. Vite+ wraps runtime management, package management, and frontend tooling in a single global CLI called vp. Vite+ is distinct from Vite, and it invokes Vite through vp dev and vp build. Run vp help to print a list of commands and vp <command> --help for information about a specific command.

Docs are local at node_modules/vite-plus/docs or online at https://viteplus.dev/guide/.

Built-in Commands vs Scripts

vp <name> runs a built-in command. vp run <name> runs a package.json script or a vite.config.ts task. Scripts cannot overwrite built-ins, so vp dev and vp run dev may do different things. Check package.json and vite.config.ts first, and run vp run <name> when the project defines a script or task with that name.

Tool Versions

Run vp toolchain to show versions and relationships in the active Vite+ release. Add a tool name to select part of the graph. For example, run vp toolchain vite. Use --global to ignore the local vite-plus package. Use vp why <package> to show the package-manager dependency graph.

Review Checklist

  • Run vp install after pulling remote changes and before getting started.
  • Run vp check and vp test to format, lint, type check and test changes.
  • Check if there are vite.config.ts tasks or package.json scripts necessary for validation, run via vp run <script>.
  • If setup, runtime, or package-manager behavior looks wrong, run vp env doctor and include its output when asking for help.

Quick Overview

Chronos is a PWA timetable app.

  • Stack: TypeScript, Svelte 5, SvelteKit, Tailwind CSS 4
  • Data & i18n: Dexie (Client-side), Paraglide (en / zh-cn), PostHog
  • Package Manager: Use vp (Vite+) CLI only (do not invoke pnpm / npm / yarn directly)
  • Developer docs: See CONTRIBUTING.md at the repository root

Write Code

Plan first; do NOT rush to code. Before planning, read .agents/skills/tobelazy/SKILL.md.

Response Format

Be concise. Do not write unsolicited "WHY" explanations.

Commit Convention

Use Gitmoji format: <emoji> <concise Chinese> (no feat:/fix: prefix). e.g., ✨ 新增课表导出功能.