generated from mountainridge-xyz/vite-webapp
2.2 KiB
2.2 KiB
Mountainridge Craft Webapp – AI Coding Agent Instructions
Purpose
This is the single source of truth.
Every AI coding agent must follow these rules exactly.
Any deviation breaks the template contract.
Core Overview
- HTML, Tailwind CSS, and Vanilla JS CSR-only responsive website
- Styling: Standalone TailwindCSS + DaisyUI components (no
tailwind.config.js) - Corporate theme: "mountainridge" (locked in
styles.css)
Agent Tool Usage (Mandatory)
All agents have the following injected tools and must use them exclusively:
craft_build– full build / serve / watch / desktop package (Cargo + Trunk + Tauri)craft_git_commitandcraft_git_push- Git commit & push all or specific set of filescraft_create_issie- create issues for the craft in the repo
Never execute raw shell commands (npm, vite, git, etc.).
All build and git operations are fully wrapped — repo details are irrelevant.
Project Structure & Immutable Rules
| Path | Purpose | Modification Rules |
|---|---|---|
./assets/ |
Extra CSS, fonts, images, static assets | Add only |
./src/main.js |
Entrypoint for the webapp and vite. | Make sure it is always compabatible with vite build |
./src/styles.css |
Global stylesheet + full "mountainridge" DaisyUI theme | Extend only – never overwrite theme block |
./index.html |
HTML entry point | Immutable section (see below) – only meta/title changes allowed |
Immutable / Protected Elements (Never Change)
./index.html – these exact lines must remain untouched (required for vite.js):
<link rel="stylesheet" href="/src/styles.css">
<script type="module" src="/src/main.js"></script>
./src/styles.css – never delete or replace the "daisyui/theme" block.