Configura l'accesso al tuo progetto OASI

Hai ricevuto un link di invito dal titolare del progetto. In 4 passi configuri tutto da solo — nessun intervento dello staff OASI — e modifichi le schermate in anteprima privata, con VS Code + Claude Code o Cursor.

Prima di cominciare: è questa la strada giusta? Questa pagina configura l'accesso via SSH e clone git. È il percorso storico.

Se il titolare ti ha dato un installer da eseguire sul tuo computer (dev-light col wrapper), non serve nulla di tutto questo: niente chiave SSH, niente clone. Il tuo lavoro viene sincronizzato dal wrapper a ogni salvataggio, e il pannello delle tue anteprime è su https://<tuo-progetto>.oasi.io/dev-light.

Nel dubbio chiedi al titolare quale dei due, e non seguire entrambi: due copie del progetto sullo stesso computer confondono gli strumenti — è già successo.
Come funziona: modifichi le schermate → vedi un'anteprima solo tua → quando sei sicuro, il titolare la pubblica in produzione. Le tue modifiche non vanno mai online da sole.
Due modi di lavorare — non confonderli:

1 · Configura il computer (una volta sola)

Un comando fa tutto: genera la chiave SSH, registra l'accesso, clona il progetto e prepara Claude/Cursor. Sostituisci <TOKEN> con il token del tuo invito (già inserito qui sotto se hai aperto il link).

🍎 macOS / 🐧 Linux — nel Terminale:

curl -fsSL https://dev.oasi.io/setup-oasi-developer.sh | bash -s -- --token=<TOKEN>

🪟 Windows — in PowerShell:

$env:OASI_TOKEN="<TOKEN>"; irm https://dev.oasi.io/setup-oasi-developer.ps1 | iex

Il token è valido pochi minuti ed è monouso. Se è scaduto, chiedi al titolare di rigenerare l'invito.

Preferisci registrare la chiave a mano?

Genera una chiave SSH e incolla la chiave pubblica:

ssh-keygen -t ed25519 -f ~/.ssh/oasi-developer -N ""
cat ~/.ssh/oasi-developer.pub

I 43 caratteri dopo #token= nel link. Non è il nome/commento della chiave.

Tutta la riga che inizia con ssh-ed25519. Non incollare la privata (id_ed25519).

2 · Installa l'estensione OASI per VS Code

L'estensione avvia e gestisce l'anteprima dal vivo da sola — niente comandi da ricordare né finestre da tenere aperte. (Con il setup automatico potrebbe essere già pronta.)

⬇️ Scarica l'estensione (.vsix)

In VS Code: apri Estensioni (Ctrl/Cmd+Shift+X) → menu ··· in alto a destra → Installa da VSIX… → scegli il file scaricato.
Oppure da terminale: code --install-extension oasi-owner-loop.vsix

Poi apri la cartella del progetto clonato: nella barra laterale compare “OASI Owner Loop” → premi ▶ Avvia live-preview. Fatto — da ora ogni salvataggio aggiorna la tua anteprima.

3 · Modifica e guarda la tua anteprima

Modifica le schermate (con Claude Code/Cursor o a mano): l'anteprima si aggiorna da sola in pochi secondi.

Per vederla: nell'estensione clicca “🌐 Apri la mia preview” — sa già qual è il tuo progetto. Si apre nel browser: accedi prima con il tuo account, poi vedi la tua sandbox.
Senza estensione: vai su https://<tuo-progetto>.oasi.io, accedi, poi apri https://<tuo-progetto>.oasi.io/api/preview/<tuo-progetto>/mint.
Atterrare su una superficie precisa (admin, ops, portal): il sandbox e' uno e copre gia' tutte le superfici — non serve un secondo ingresso, basta dire dove vuoi arrivare:
…/api/preview/<tuo-progetto>/mint?to=/admin/users
Riscrivere l'URL a mano dopo essere entrato porta invece al login: entra con ?to=. L'accesso resta quello di produzione — una superficie per cui non hai il ruolo risponde «non autorizzato» anche in anteprima, ed e' corretto: la bozza governa cio' che vedi, mai i permessi.

4 · Pubblica in produzione

Quando l'anteprima ti convince, apri https://<tuo-progetto>.oasi.io/p/<tuo-progetto>/dev-light → Richiedi adozione. A mandarla online è il titolare, con Approva + pubblica. Solo il titolare può pubblicare.

Non /studio/preview-publish: quello è il banco del titolare, dietro il gate operatore di piattaforma — chi sviluppa in dev-light lo trova chiuso.

Da ricordare (poche cose):