# 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.