# Evensiva Docs HTML Style Guide

**Use this UI/UX style for every `.html` documentation file in this project.** This keeps setup guides, architecture docs, and feature references consistent.

## Reference file

- **Reference:** `docs/setup/environment-and-deployment-guide.html` — copy its `<head>` (meta, title, fonts, `<style>`) and body structure when creating or updating any HTML doc.

## Design system

- **Theme:** Dark. Background `#0c0f14`, surface `#151922`, text `#e6e9ef`, muted `#8b92a4`.
- **Fonts:** DM Sans (body), JetBrains Mono (code). Load from Google Fonts (see reference file).
- **Accent:** `#6366f1` (links, code, active nav). Hover `#818cf8`.
- **Semantic colors:** Success `#22c55e`, warning `#f59e0b`, error `#ef4444`.

## Structure

1. **Layout:** Grid with sidebar + main.
   - `.layout` — `display: grid; grid-template-columns: 220px 1fr; max-width: 1000px; margin: 0 auto;`
   - At `max-width: 768px` use single column (sidebar above main).

2. **Sidebar (`.sidebar`):**
   - Sticky, dark surface, border-right.
   - `.logo` — "Evensiva" (or doc context).
   - `.nav-list` — `<ul>` of `<a href="#section-id">` linking to each major section (h1/h2 with id). First link can have class `active`.

3. **Main (`.main`):**
   - `.doc-title` — main title (h1-size).
   - `.doc-subtitle` — short description, muted color.
   - Then content: `<h1 id="...">`, `<h2>`, `<p>`, `<ul>`, `<pre>`, `<table>`, etc.

## CSS classes to include

Copy the full `<style>` block from the reference HTML file. It defines:

- **Layout:** `.layout`, `.sidebar`, `.main`, `.logo`, `.nav-list`, `.nav-list a`, `.nav-list a.active`
- **Typography:** `.doc-title`, `.doc-subtitle`, `h1`, `h2`, `h3`, `p`, `ul`, `ol`, `li`, `code`, `pre`
- **Components:** `.card`, `.card-title`, `.do`, `.dont`, `.note`, `table`, `th`, `td`, `a`

## Head template

```html
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Page Title | Evensiva</title>
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
<style>
  /* Paste full :root + all classes from reference file */
</style>
```

## Body template

```html
<body>
  <div class="layout">
    <aside class="sidebar">
      <div class="logo">Evensiva</div>
      <nav>
        <ul class="nav-list">
          <li><a href="#overview" class="active">Overview</a></li>
          <!-- one <li><a href="#id">Section name</a></li> per major section -->
        </ul>
      </nav>
    </aside>
    <main class="main">
      <h1 class="doc-title">Document Title</h1>
      <p class="doc-subtitle">Short description.</p>
      <h1 id="overview">Overview</h1>
      <!-- content -->
    </main>
  </div>
</body>
```

## Rules

- Every HTML doc must use this dark theme, layout (sidebar + main), fonts, and structure.
- Give each major section an `id` and add a matching link in the sidebar.
- Keep the same CSS variables and class names so future edits stay consistent.
- **File extension:** Prefer **.html** for new docs (same dark layout). Use **.md** only when the doc is referenced from code or rules.
- **Always update the index:** When you add any new doc, add an entry to `docs/documentation-index.json` so it appears in the documentation.
- **Screenshots:** Put PNGs under `public/Images/docs/` and reference them as `/Images/docs/filename.png` (capital **`I`** — URLs are case-sensitive on Linux production hosts).
