generated from mountainridge-xyz/vite-webapp
46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# 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_commit` and `craft_git_push` - Git commit & push all or specific set of files
|
||
- `craft_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):
|
||
|
||
```html
|
||
|
||
<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.
|
||
|