Salta al contenuto
supastack
Sfoglia la documentazione
WebNext.js

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/web/tech-stack.md (or send Accept: text/markdown).

Stack tecnologico

Le tecnologie dietro il kit e il ruolo di ciascuna.

Chiedi informazioni su questa guida
Apri in

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.

corepack pnpm --filter @supastack/web dev

Stack applicativo

L'app web è un'applicazione Next.js composta da pacchetti TypeScript condivisi — gli stessi pacchetti alimentano l'app mobile Expo. Il chrome del prodotto usa CSS Modules sui design token, quindi non c'è CSS-in-JS a runtime da debuggare, e lo storage di oggetti è compatibile con S3. Gli strumenti seguenti sono i default scelti.

Next.js + React

L'app web esegue Next.js 16 con l'App Router e i server component di React 19.

TypeScript + Turborepo

La modalità strict di TypeScript si applica a tutto il workspace pnpm, e Turborepo coordina le build.

Better Auth

Better Auth è il motore di identità; è disponibile un motore Auth.js per i team che lo standardizzano.

Drizzle + PostgreSQL

La persistenza passa attraverso l'ORM Drizzle su PostgreSQL — lo schema e gli helper attraverso cui passa ogni record.

Fatturazione

La fatturazione Stripe è il default, ed è incluso un adattatore per Lemon Squeezy.

Trigger.dev

I job in background girano su Trigger.dev.

Email transazionale

Le email transazionali vengono inviate tramite Resend o AWS SES.

Sentry + PostHog

L'osservabilità passa per Sentry e PostHog.

Expo

L'app mobile Expo consuma gli stessi pacchetti TypeScript, quindi le modifiche ai contratti vengono verificate su entrambe le superfici contemporaneamente. Expo compila per iOS e Android.

Moduli condivisi

Ogni capacità trasversale vive in un pacchetto con un piccolo contratto: auth, db, billing, ai, jobs, email, storage, observability, config, i18n e api. Le applicazioni li compongono; la logica di dominio del prodotto resta fuori dal kit.

Ogni modulo basato su provider include un adattatore fake o locale così il ciclo di test e sviluppo predefinito non chiama mai un servizio a pagamento.

Strumenti di verifica

Vitest copre il comportamento unitario e di integrazione, Playwright copre i flussi browser, ed ESLint più Prettier mantengono il codice coerente. La suite deterministica gira senza credenziali provider; l'accettazione con provider reali è un percorso separato e opzionale.

corepack pnpm test          # deterministic unit + integration
corepack pnpm check         # lint, types, tests, format
corepack pnpm build         # production builds
corepack pnpm test:e2e      # browser flows

Domande frequenti

14 domande

Cos'è supastack?

supastack è una base modulare per costruire prodotti SaaS con AI. Riunisce l'infrastruttura comune così puoi concentrarti sulle funzionalità proprie del tuo prodotto.

Supporta web e mobile?

Sì. supastack include app Next.js ed Expo come punti di partenza per esperienze web e mobile.

Quale autenticazione è inclusa?

Better Auth copre email/password, OTP e login social. I workspace personali vengono provisionati con l'account così i record restano delimitati fin dal primo giorno.

Come è supportata l'AI?

supastack include AI multi-provider configurabile, tracciamento dell'uso, budget e supporto cifrato per le proprie chiavi (BYOK).

Come vengono gestiti gli abbonamenti?

Per i prodotti costruiti sul kit, fatturazione Stripe, abbonamenti e permessi formano la base dell'accesso a pagamento. I segreti dei provider restano lato server.

Dove vive il codice specifico del mio prodotto?

Le funzionalità specifiche del prodotto restano in un codebase separato, mentre il prodotto configura e integra i moduli base di supastack.

Come funziona il prezzo di supastack?

Il kit è un acquisto unico con aggiornamenti a vita: Un framework a 249 $ (prezzo di lancio temporaneo — 100 $ di sconto sul prezzo di listino di 349 $) oppure Tutti i framework (Next.js, iOS, Android) a 499 $ (prezzo di lancio temporaneo — 100 $ di sconto sul prezzo di listino di 599 $), più 75 $ per posto sviluppatore aggiuntivo. Nessun abbonamento al kit. Il checkout su questo sito consegna la tua chiave di licenza via email, con accesso al repo tramite invito GitHub.

Come delimitano i workspace i miei dati?

I record utente sono delimitati da workspaceId. Identità, permessi, uso AI, eventi di fatturazione e voci di audit restano dentro il confine del workspace personale.

Come funzionano i job in background?

Trigger.dev è il runtime di job esplicito. Il contratto JobRunner promette solo enqueue, status e cancel — la semantica di workflow resta specifica ed esplicita di Trigger.dev.

In cosa differisce l'email dall'outreach?

L'email transazionale copre i flussi di prodotto come gli avvisi di completamento delle attività. L'outreach a freddo e le campagne appartengono al prodotto, fuori dal modulo email di questo kit.

Come funzionano gli acquisti su mobile?

La versione mobile include acquisti nativi e ripristino tramite RevenueCat, con accesso verificato dal server. Configura gli account degli store e completa i test sui dispositivi prima della pubblicazione. I pagamenti web restano separati.

Dove risiedono le chiavi dei provider AI?

Le credenziali BYOK sono cifrate e restano lato server. Le chiavi vengono sanificate nei log; uso e budget restano visibili a livello di workspace.

Quali metodi di pagamento accetta il checkout?

Il checkout ospitato da Stripe accetta le carte e può offrire anche Alipay e WeChat Pay una volta attivati i wallet sull'account Stripe — utile per gli acquirenti in Cina. Le autorizzazioni dei wallet vengono confermate in modo asincrono, quindi la pagina della licenza si aggiorna non appena il pagamento va a buon fine.

Posso ottenere un rimborso?

Una volta ottenuto l'accesso al repository, supastack è tuo per sempre, quindi non può essere rimborsato. Ma non preoccuparti: ricevi il codice sorgente completo con aggiornamenti a vita per creare e lanciare prodotti illimitati per te o per i tuoi clienti. L'unica condizione è che non puoi rivendere il codice né ridistribuire il repository come starter kit o modello.

IT
Tema