Tecnico

Per prima cosa apri la pagina di stato del build: ogni fase ha un pulsante Log che mostra esattamente dove ha fallito. La maggior parte degli errori rientra in tre categorie: un singhiozzo transitorio dell'infrastruttura (clicca Retry), un errore di codice che l'IA può sistemare da sola (apri una chat con "il build è fallito, l'errore è: …" e incolla la riga di log) o un problema con un servizio collegato (Stripe, GitHub, il tuo provider di dominio). Se nulla di tutto questo, scrivi al supporto con l'ID progetto — possiamo rilanciare la pipeline manualmente.

Tre cause comuni. (1) Il DNS non si è ancora propagato del tutto — attendi 5–15 minuti e fai hard refresh. (2) Il browser ha messo in cache un asset vecchio — apri in finestra in incognito. (3) L'output del primo build era sintatticamente valido ma logicamente sbagliato — apri una chat con "la home appare bianca quando la apro" e l'IA lo sistema al prossimo refinement. La console del browser (F12 → Console) di solito mostra l'errore vero.

I build girano in una coda condivisa. Free e Starter hanno priorità standard e possono attendere qualche minuto nelle ore di punta; Pro e Business hanno slot prioritari e quasi mai aspettano. Se il tuo build è in coda da più di 10 minuti, non è normale — ricarica la pagina (lo stato passa via websocket e a volte la connessione cade) e se ancora non parte, scrivi al supporto con l'ID del progetto.

Sì. Apri il progetto, clicca sul menù a tre puntini e scegli "Redeploy". Il tuo codice resta esattamente lo stesso — ma le nuove variabili d'ambiente vengono lette, gli artefatti di build scaduti vengono ricostruiti e i miglioramenti lato piattaforma (es. patch di sicurezza nel runtime) vengono applicati. Un redeploy senza modifiche costa 1 credito e finisce in meno di un minuto.

Su AWS, di default nella region us-east-1. Gli asset statici vengono serviti dalla rete edge globale di CloudFront, quindi i tuoi visitatori colpiscono un PoP vicino a prescindere da dove si trovi l'origine. Il rendering server-side gira su AWS Lambda, il database del progetto è su Amazon RDS Postgres e i file caricati stanno su S3. La data-residency nell'UE è in roadmap ma non ancora disponibile — segnala al supporto se è un requisito vincolante.

Sì — il codice del tuo progetto vive in un repo GitHub che abbiamo creato a tuo nome. Apri Impostazioni del progetto → Repository per vedere l'URL e dare accesso in scrittura al tuo account. Clonare, forkare o spostare in un'altra org GitHub funziona come con qualsiasi repo. Lo stesso vale per il database (esponiamo una stringa di connessione Postgres sotto Impostazioni → Database → Esporta). Mantieni la proprietà del codice e dei dati; FloopFloop è uno strato di deploy + IA sopra.

Su Pro o superiore: apri il progetto, vai in Impostazioni → Domini, clicca "Aggiungi dominio" e inserisci il tuo dominio (root o sottodominio). FloopFloop mostra due record DNS da aggiungere dal tuo registrar — un CNAME (o A/ALIAS per un dominio apex) e un TXT per la verifica. Quando entrambi vengono rilevati, l'SSL viene predisposto in automatico e il dominio va online, di solito in 5–30 minuti. Free e Starter non supportano domini personalizzati; serve l'upgrade.

La maggior parte dei problemi è lato DNS. Verifica che il record CNAME (o A/ALIAS) esista, punti al valore mostrato da FloopFloop e non sia dietro un proxy che blocca la nostra verifica (la "nuvola arancione" di Cloudflare va disattivata finché la verifica non finisce — la riattivi dopo). Usa `dig il-tuo-dominio.com +short` dal terminale per vedere cosa vede il resto del mondo. La verifica di solito impiega meno di 15 minuti; se dopo un'ora la dashboard è ancora "Pending", scrivi al supporto con il dominio.

Tutti i secrets sono cifrati a riposo con AES-256 in AWS Secrets Manager e decifrati solo al momento della richiesta nel runtime del tuo progetto — non vengono mai scritti su disco o nei log di build. Una volta salvato, un secret è write-only: puoi aggiornarlo o cancellarlo, ma non rileggerlo dalla dashboard. Lo staff di FloopFloop non ha accesso ai valori in chiaro; vediamo solo il nome della chiave e i metadati di audit.

Sì. Apri Impostazioni → Secrets, trova l'elemento, clicca su "Ruota" e incolla il nuovo valore. In circa 30 secondi il runtime attivo inizia a leggere il nuovo valore (ricarichiamo i secrets a caldo, senza riavviare la funzione). Se il secret fa parte di una configurazione di build-time (raro), apparirà un banner che chiede il redeploy — circa un minuto e 1 credito.

Dì all'IA in chat: "aggiungi un cron che gira ogni giorno alle 9 e mi manda via email un riepilogo delle nuove iscrizioni". L'IA genera una route `/api/cron/<nome>` nel tuo codice, registra lo schedule (espressione cron o intervallo) e a ogni redeploy il nostro scheduler tiene la registrazione sincronizzata. Ogni invocazione arriva con un bearer token con scope sul progetto, quindi solo il nostro scheduler può scatenarla. Esecuzioni e log si vedono in Impostazioni → Pianificazioni.

Su macOS e Linux: `curl -fsSL https://floop.tech/install.sh | sh`. Su Windows: scarica l'ultimo installer dalla pagina Releases di GitHub del repo floop-cli, oppure usa `winget install FloopFloopAI.floop`. Una volta installato, esegui `floop login` — si apre un browser per autorizzare questo dispositivo. Da lì, `floop new`, `floop refine`, `floop deploy` e gli altri comandi funzionano senza ulteriore setup.

Un token CLI è la credential che `floop login` scrive nella tua config locale — identifica l'utente umano su un dispositivo specifico, e puoi revocarlo da /account/devices quando smetti di usare un laptop. Una API key serve per accesso non presidiato da script, CI o app di terze parti — le crei sotto /account/api-keys, puoi limitarle a un progetto se vuoi e ruotarle quando vuoi. Entrambe parlano con la stessa superficie `/api/v1/*`, ma solo le API key dovrebbero finire nelle automazioni.

Sì — gli otto SDK ufficiali (Node, Python, Go, Rust, Ruby, PHP, Swift, Kotlin) avvolgono tutti la stessa superficie `/api/v1/*` e hanno nomi di metodo allineati. Quando aggiungiamo un endpoint, lo specchio in tutti gli SDK nella stessa release. Il server MCP (`@floopfloop/mcp`) riespone l'SDK Node agli agenti LLM e riceve il nuovo metodo in automatico. Se noti una mancanza è un bug — apri una issue sul repo dell'SDK in questione.