Guida rapida

Crea il tuo primo modulo Insolitum Universe in 5 minuti.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Node.js >= 18.0
• pnpm >= 8.0
• Accesso a un'istanza Supabase
• Un'istanza Universe Shell in esecuzione

Crea un nuovo modulo

Il modo piu rapido per creare un nuovo modulo:

npx create-insolitum-module my-analytics

La CLI ti chiedera il nome del modulo, il nome visualizzato, la descrizione, la categoria, l'URL di Supabase e la chiave anonima di Supabase.

Installazione ed esecuzione

cd my-analytics
pnpm install
pnpm dev

Il tuo modulo e in esecuzione su http://localhost:3010.

Test dell'endpoint di stato

curl http://localhost:3010/api/health

Risposta attesa:

{
  "status": "ok",
  "module": "my-analytics",
  "version": "1.0.0"
}

Test in Universe Shell

1. Avvia Universe Shell
2. Accedi come amministratore
3. Vai su Admin Panel → Modules
4. Aggiungi il modulo con URL: http://localhost:3010
5. Il modulo si carica con autenticazione automatica

Deploy su Vercel

1. Carica il codice in un repository Git
2. Crea un progetto su Vercel
3. Aggiungi le variabili d'ambiente
4. Esegui il deploy

Prossimi passi

• Architecture — Come funzionano i moduli
• Authentication — Integrazione dell'autenticazione
• Database — Accesso ai dati
• Marketplace — Pubblica e guadagna