> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# SEO e condivisione

Metadata, sitemap, robots e immagini social.

## Prima di iniziare

Apri il progetto supastack scaricato in Visual Studio Code utilizzando File → Apri cartella, quindi scegli Terminale → Nuovo terminale. La radice del repository è la cartella contenente package.json, app e pacchetti. Esegui il comando qui sotto e lascia il suo terminale aperto. Se un comando non viene riconosciuto, completare la guida all'installazione dello strumento prima di continuare.

Leggi prima il tutorial sulla piattaforma. Un server è il processo dell'app che risponde alle richieste del browser o del telefono. Il Web legge apps/web/.env.local, Expo legge apps/mobile/.env.local e i comandi di migrazione del database leggono root .env. La dimostrazione senza database/dashboard è separata dagli account reali/auth, che necessitano della migrazione Postgres. Un pagamento solo telefonico o desktop richiede un backend Web eseguito separatamente.

[Installa gli strumenti e ottieni il codice](https://supastack.dev/it/docs/web/before-you-start.md)

[Impara comandi, file e configurazione](https://supastack.dev/it/docs/web/terminal-basics.md)

[Completa il tutorial di prima esecuzione sul Web](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## Installazione e configurazione

I metadata a livello di rotta vengono dalla metadata API di Next.js — le pagine esportano un oggetto metadata o generateMetadata, risolvendo titoli e descrizioni dai dizionari di locale così i risultati di ricerca restano localizzati.

sitemap.ts e robots.ts generano la superficie scansionabile; l'immagine Open Graph e gli asset icona portano l'anteprima social. Tieni le rotte private — settings, billing, admin, API — fuori dalla sitemap e in disallow su robots.

```
app/sitemap.ts    public routes only
app/robots.ts     disallow private surfaces

// per page
export const metadata = { title, description };
```


## Flusso di implementazione

Dai a ogni pagina pubblica un titolo e una descrizione unici; non indicizzare mai risultati di ricerca, viste filtrate o superfici autenticate. Gli URL canonici restano senza prefisso — il layer locale reindirizza già il locale di default al percorso canonico.

Quando aggiungi una rotta pubblica, aggiungila alla sitemap nella stessa modifica. Mantieni le immagini OG sui token di brand invece di screenshot fissi, così i restyle restano coerenti.


## Verifica e risoluzione dei problemi

Recupera /robots.txt e /sitemap.xml su un deploy di preview, valida che la sitemap si parsi e fai share-check di una pagina — titolo, descrizione, immagine. Conferma un header o meta noindex sulle pagine dei risultati di ricerca.


## Successivo

[Temi di prodotto](https://supastack.dev/it/docs/web/theming.md)