Salta al contenuto
supastack
Sfoglia la documentazione
WebTanStack Start

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/tanstack/marketing-site.md (or send Accept: text/markdown).

Pagine di marketing

Sezioni landing, pagine legali, FAQ, changelog e la config del sito.

Procedura dettagliata per principianti

Prerequisiti: leggi le due guide per principianti di seguito, completa la configurazione locale del Web e apri questo monorepo alla radice nel tuo editor. Le impostazioni Web appartengono a apps/web-tanstack/.env.local; TanStack Start non legge la radice .env. /dashboard nella modalità falsa predefinita è una demo senza database; /auth necessita di un database migrato.

Termini rapidi: uno spazio di lavoro è costituito da utenti, dati e impostazioni separati di un team. Il server è il backend affidabile; mantenere le chiavi del provider fuori dal browser e dal codice del telefono. Una migrazione è una modifica del database con versione che crea o aggiorna tabelle. Un modello AI è il motore che risponde; il catalogo dei modelli è l'elenco del server degli ID e dei prezzi dei modelli disponibili. Un fornitore è un servizio esterno come un servizio di intelligenza artificiale, posta elettronica o fatturazione. Un diritto è una concessione che consente a un'area di lavoro di utilizzare una funzionalità. Un webhook è un messaggio che un servizio invia allo URL di un altro servizio.

1. Apri packages/web-core/src/marketing/site-config.ts e modifica il nome del prodotto, lo slogan, le etichette/URL di navigazione e l'indirizzo di supporto con i valori di tua proprietà.

2. Sostituisci apps/web-tanstack/public/og.png e aggiorna il testo alternativo e le dimensioni in packages/web-core/src/marketing/seo.tsx come una modifica.

3. Aggiorna la home page, FAQ, il piè di pagina e l'anteprima social. Se rimane il vecchio testo, cerca questo repository con il vecchio nome prima di pubblicarlo.

Per il codice personalizzato, inizia con prompts/README.md in dotazione e copia il prompt più vicino: prompts/new-app-screen.md per la schermata di un'app o prompts/new-landing-page.md per una pagina pubblica. Per il lavoro su server, database o provider, assegna al tuo agente di codifica il compito di questa guida e chiedigli di leggere AGENTS.md, .ai/PROJECT_CONTEXT.md e i mirror .ai/ corrispondenti; controllare gli esatti file sorgente nominati qui; elencare file e controlli prima della modifica; preservare la proprietà dello spazio di lavoro e i segreti solo del server; e mostrarti la differenza. Indicagli il comportamento desiderato, i campi di input e output, i ruoli consentiti, i successi e gli errori previsti e l'account, il fornitore o il dispositivo di prova. Utilizzare valori campione; non incollare mai un vero segreto.

Aggiorna la configurazione del sito

packages/web-core/src/marketing/site-config.ts possiede copia del marchio, collegamenti di navigazione/piè di pagina, FAQ e destinazioni di repository/documenti opzionali. Aggiornalo prima di sparpagliare i nomi dei prodotti tra i componenti. Il chrome del kit utilizza questa configurazione; i blocchi chrome copiabili accettano props di prodotto.

Sostituisci la famiglia di asset insieme

Il segno condiviso di quattro tessere ha tessere bianche in alto a sinistra/in basso a destra e grigie in alto a destra/in basso a sinistra con contorni sottili. Mantieni trasparenti i segni di intestazione; le icone/favicon delle app utilizzano il supporto nero arrotondato. I prodotti derivati ​​possono sostituire insieme il marchio e le risorse app/desktop associate.

La social card pubblica condivisa è /og.png; aggiorna il suo descrittore in marketing/seo.tsx con le dimensioni e il testo alternativo. Le schede degli articoli del blog usano la loro route OG rasterizzata separata (src/framework/og.ts).

Controlla ogni superficie pubblica

Verifica intestazione/piè di pagina, contatto, FAQ, pagine legali, copia home localizzata, titoli e social card. Scegli la modalità del tema di marketing del tuo prodotto e invia solo collegamenti di supporto/contatto che funzionano.

Installazione e configurazione

La superficie marketing è collegata a dati tipizzati invece che a JSX hardcoded — hero, sezioni feature, pricing, FAQ, changelog, showcase, contatti e pagine legali leggono copy e struttura dalla configurazione del sito e dai file di contenuto.

MARKETING_THEME_MODE (src/theme/marketing-theme.ts) decide se il marketing resta sul brand scuro bloccato del kit, eredita il theme pack del visitatore o fissa un pack specifico. I prodotti derivati scelgono la propria modalità.

src/marketing/         branded chrome and sections
src/kit/blocks/        copyable token-only section patterns
  marketing/           hero, features, product grid, pricing, FAQ, CTA
  app/                 stat grid, data table, empty state, choice pills
  chrome/              site header, footer, prose page

MARKETING_THEME_MODE = "locked" | "inherit" | "<pack-id>"

Flusso di implementazione

Componi le pagine prima dalla libreria di block; scrivi un nuovo block nello stesso stile solo-token quando manca un pattern e registralo in src/kit/blocks.ts. Tieni i componenti marketing fuori dalle superfici di prodotto — i due sistemi di chrome restano separati.

La copy localizzata scorre attraverso il dizionario e gli overlay di site-content; aggiungi chiavi lì invece di forkare componenti per lingua.

Verifica e risoluzione dei problemi

Controlla una pagina marketing a 320px e desktop, con focus da tastiera visibile, sotto almeno un pack chiaro e uno scuro, e con reduced motion. Se un claim di marketing cita una capacità, assicurati che la pagina doc collegata esista.