📚 Documentazione Elerama Frontend

Questa documentazione è gestita con VitePress, un generatore di siti statici ottimizzato per documentazione tecnica.

🚀 Quick Start

Avviare il server di sviluppo

npm run docs:dev

Apri http://localhost:5173/docs/ nel browser.

Build per produzione

npm run docs:build

I file compilati saranno generati in docs/.vitepress/dist/.

Preview della build

npm run docs:preview

📝 Aggiungere Nuova Documentazione

1. Crea un file Markdown nella cartella appropriata (es. docs/auth/nuova-guida.md)
2. Aggiungi il link in docs/.vitepress/config.ts nella sezione sidebar
3. Usa il frontmatter YAML (opzionale) per metadata aggiuntivi

Esempio di file con frontmatter

---
title: Titolo della Pagina
description: Descrizione della pagina
---

# Contenuto della Pagina

...

🎨 Personalizzazione

La configurazione principale si trova in docs/.vitepress/config.ts:

• Sidebar: Modifica themeConfig.sidebar per aggiungere/rimuovere voci
• Navbar: Modifica themeConfig.nav per la barra di navigazione superiore
• Tema: Personalizza colori e stili in docs/.vitepress/theme/
• Home Page: Modifica docs/index.md per la pagina principale

📁 Struttura

docs/
├── .vitepress/
│   ├── config.ts         # Configurazione VitePress
│   ├── cache/            # Cache (ignorata da git)
│   └── dist/             # Build output (ignorata da git)
├── index.md              # Home page
├── auth/                 # Documentazione autenticazione
├── cart/                 # Documentazione carrello
├── api/                  # Documentazione API
└── ...                   # Altre categorie

🔍 Features

• ✅ Ricerca locale integrata
• ✅ Syntax highlighting per codice
• ✅ Dark mode automatico
• ✅ Mobile responsive
• ✅ Hot reload in sviluppo
• ✅ SEO friendly

📖 Risorse

• VitePress Documentation
• Markdown Extensions
• Default Theme Config

---

Nota: La documentazione è versionata insieme al codice. Aggiorna i docs quando modifichi features!