SEO e condivisione

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-tanstack/.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 checkout solo telefono o desktop richiede un backend Web eseguito separatamente.

• Installa gli strumenti e ottieni il codice
• Impara comandi, file e configurazione
• Completa il tutorial di prima esecuzione sul Web

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

Installazione e configurazione

I metadata a livello di rotta vengono dai moduli di pagina condivisi — ogni packages/web-core/src/pages/<route>/page.load.ts esporta metadata che la sua file route espone tramite head() via metadataToHead, risolvendo titoli e descrizioni dai dizionari di locale così i risultati di ricerca restano localizzati.

Le route src/routes/sitemap[.]xml.ts e src/routes/robots[.]txt.ts generano la superficie scansionabile; l'immagine OG rasterizzata (src/framework/og.ts) e gli asset icona portano l'anteprima social. Tieni le rotte private — settings, billing, admin, API — fuori dalla sitemap e in disallow su robots.

src/routes/sitemap[.]xml.ts   public routes only
src/routes/robots[.]txt.ts    disallow private surfaces

// per page — packages/web-core/src/pages/<route>/page.load.ts,
// surfaced through the route's head() via metadataToHead
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.