Configura Atlas — SaaS per la gestione del noleggio auto

Hosting Hostinger

Il codice di Atlas è gratuito; l'hosting è un piano a pagamento. Il tuo sito online gira qui.

Scegli un piano Hostinger

Usa il piano Unlimited o un piano Cloud con deploy Web App.

Claude Desktop

Il tuo assistente IA per la configurazione. Claude fa il lavoro tecnico nella sua scheda Code.

Scarica Claude Desktop

https://claude.ai/download

Node.js

Versione 20.19 o successiva. Al resto pensa Claude.

Scarica Node.js

https://nodejs.org/en/download

Git

Serve a pubblicare la tua copia di Atlas. Claude esegue i comandi Git per te.

Scarica Git

https://git-scm.com/

Account Supabase

Il piano gratuito basta per iniziare. Creerai un nuovo progetto quando Claude te lo chiederà.

Crea un account Supabase

https://supabase.com/dashboard

Account GitHub

Gratuito. Contiene la tua copia privata di Atlas, da cui Hostinger esegue il deploy.

Crea un account GitHub

https://github.com/signup

Scarica Atlas

Atlas è gratuito e open source con licenza MIT.

Apri Atlas su GitHub

https://github.com/salhiworks/atlas-car-rental-saas

Clicca su Code, poi su Download ZIP Decomprimi il file scaricato Tieni la cartella atlas-car-rental-saas-main in un posto facile da trovare, come Documenti

Usi già Git? Puoi invece clonare il repository. La configurazione di Claude funziona in entrambi i casi.

Apri Atlas in Claude Desktop

Claude Desktop Code Local Select Project Folder Open Trust Workspace

Scegli proprio la cartella di Atlas, quella che contiene README.md.

Chiedi a Claude di configurare Atlas

Nella scheda Code, con la cartella di Atlas aperta, invia questo messaggio:

Prompt di configurazione di Atlas

Avvia la configurazione integrata di Atlas. Claude fa il lavoro tecnico per te.

Set up Atlas for me.

Claude segue la skill di configurazione integrata di Atlas. Controlla il tuo computer, installa ciò che serve ad Atlas e fa da solo il lavoro tecnico. Si ferma solo quando ha bisogno di te, e ognuno di quei momenti è un'attività di questa guida.

Crea il tuo progetto Supabase

Claude te lo chiede per primo. Atlas va sempre in un progetto nuovo e vuoto.

Apri la dashboard di Supabase

https://supabase.com/dashboard

Clicca su New project: il piano Free va benissimo Dagli un nome e salva la password del database in un posto sicuro Quando è pronto, copia il suo Project ID e incollalo in Claude

Supabase Project Settings General

Se Claude ti chiede di accedere a Supabase o di collegare il tuo progetto, segui esattamente le istruzioni che ti dà.

Approva l'installazione

Claude mostra il nome, la regione e la data di creazione del tuo progetto e chiede di installarvi Atlas. Verifica che sia il progetto che hai appena creato, poi rispondi yes. Quell'unico yes copre tutto il resto:

Crea il database di Atlas (54 migrazioni, prima in anteprima)

Esegue il deploy e verifica le 4 Edge Functions di Atlas

Configura l'app solo con la tua publishable key

Esegue la build e i controlli automatici di Atlas

Ci vogliono pochi minuti, e non devi aprire né testare nulla. Se il progetto non è vuoto, Claude si ferma e non modifica nulla.

Crea un repository privato vuoto

È la tua copia di Atlas su GitHub. Hostinger esegue il deploy del tuo sito da qui.

Crea un repository GitHub

https://github.com/new

Dai un nome al repository Scegli Private Lascia disattivati README, .gitignore e license Clicca su Create repository Copia l'URL del repository

Approva la pubblicazione

Incolla l'URL del repository in Claude quando te lo chiede. Claude prepara Git, controlla che non siano inclusi secret e mostra un breve riepilogo: il tuo repository e il branch main. Verifica che il repository sia tuo, poi rispondi yes.

Claude non fa mai push sul repository originale di Atlas. Se Git ti chiede di accedere, Claude ti chiede di eseguire tu il push: accedi tramite il browser, perché lì GitHub non accetta la password del tuo account.

Importa il tuo repository

Non hai ancora un hosting? Prendi prima un piano in Requisiti.

Hostinger Websites Add Website Web App Import Git Repository

Collega GitHub e scegli Only select repositories Seleziona il tuo repository di Atlas e il branch main Scegli il dominio temporaneo gratuito o il tuo dominio

Imposta la build ed esegui il deploy

Mantieni il preset di framework Vite rilevato da Hostinger Scegli Node.js 22 o la versione più recente disponibile Imposta il comando di build su npm run build Imposta la directory di output su dist

Aggiungi esattamente queste due variabili d'ambiente. Claude ti mostra entrambi i valori, e puoi ignorare qualsiasi altro suggerimento:

VITE_SUPABASE_URL VITE_SUPABASE_PUBLISHABLE_KEY

VITE_SUPABASE_URL

URL del progetto

VITE_SUPABASE_PUBLISHABLE_KEY

Publishable key

Recupera questi valori da Supabase

Apri Connect

https://supabase.com/dashboard/project/_?showConnect=true

Sicurezza

Qui va solo la Publishable key. Non aggiungere mai una Secret key o una chiave service_role a una variabile VITE_: tutto ciò che inizia con VITE_ è visibile nel browser.

Clicca su Deploy e attendi che la build finisca Copia l'indirizzo del tuo sito e incollalo in Claude

Claude verifica che il sito online si carichi in HTTPS e sia collegato al tuo progetto Supabase.

Aggiungi il tuo indirizzo online a Supabase

Le e-mail di registrazione e di password rimandano a questi indirizzi. Claude ti invia la Site URL esatta e i quattro Redirect URLs per il tuo dominio Hostinger: copiali dal messaggio di Claude.

Supabase Authentication URL Configuration

Imposta la Site URL sul tuo indirizzo online, che inizia con https:// Aggiungi i quattro Redirect URLs, uno alla volta Clicca su Save, poi di' a Claude che hai finito

Ogni Redirect URL è il tuo indirizzo online seguito da uno di questi percorsi:

/auth/callback

/accept-invite

/auth/reset-password

/confirm-email

Crea la tua agenzia

Apri il link di registrazione che ti dà Claude: il tuo indirizzo online seguito da /sign-up Crea la tua agenzia con la stessa e-mail del tuo account Supabase Apri l'e-mail di conferma nello stesso browser Accedi, poi avvisa Claude quando la dashboard mostra la tua agenzia

Perché la stessa e-mail: l'e-mail integrata di Supabase raggiunge solo gli indirizzi del tuo team Supabase, circa due messaggi all'ora. Claude poi conferma che la tua agenzia esiste e che tu ne sei l'Owner: non devi testare nulla.

Atlas è online. Ogni push sul branch main ora ne esegue di nuovo il deploy su Hostinger, quindi chiedi a Claude qualsiasi modifica, compresi il tuo nome, il logo o i colori, poi chiedigli di fare il push.

Prima dei clienti reali

Collega il tuo provider e-mail (Custom SMTP) prima che si registrino clienti o personale esterni al tuo team Supabase:

Supabase Authentication Emails SMTP Settings