Risolvere i problemi

1. Vai alla dashboard dell’app.
2. Clicca Overview.
3. Sotto App Visibility, seleziona Public.

1. Crea un’app separata per la landing page pubblica.
2. Pubblica entrambe le app.
3. Collega questa landing app all’app principale privata.
4. Assegna il dominio primario all’app della landing page e un sottodominio all’app privata.

• Chiedi all’IA di creare una landing pubblica, impostala come default per tutti gli utenti.
• Blocca tutte le altre pagine dietro RLS (così solo gli utenti loggati possono vederle).
• Configura i redirect: Chi è disconnesso è inviato alla landing, gli utenti loggati sono inviati alla dashboard.
• Suggerimento di prompt:
  “Please implement a landing page for our app that allows users to login/signup at /Login utilizing our existing theme. Make sure all pages except the landing page are secured behind RLS and that logged-in users can’t access the landing page but are redirected to the dashboard.”

1. Clicca l’icona Revert su un messaggio della chat per ripristinare l’app a una versione funzionante precedente.
2. Apri la cronologia versioni (icona dell’orologio nella chat AI) e torna a una versione più vecchia dove cliccare non causava lo schermo bianco.
3. Prova a descrivere il problema alla chat AI con dettagli più specifici, come esattamente dove, quando e come appare il problema.

1. Verifica di usare un browser supportato e aggiornato.
2. Svuota cache del browser e cookie di Base44.
3. Disattiva le estensioni del browser, specialmente ad blocker o strumenti di privacy.
4. Apri l’editor in una finestra in incognito o prova un altro browser.
5. Controlla la community Discord per interruzioni segnalate.
6. Se l’editor ancora non funziona, fai uno screenshot degli errori (specialmente dalla console del browser) e contatta il supporto con i dettagli di browser e sistema operativo.

1. Svuota cache del browser e del dispositivo, poi ricarica l’app.
2. Controlla l’app da un altro browser o dispositivo.
3. Assicurati di aver cliccato Publish e visto un messaggio di successo.
4. Se hai aggiornato una funzione di backend, ripubblicala dalla dashboard.
5. Cerca eventuali log di errore nella dashboard di Base44.
6. Se niente funziona, includi il link dell’app e i dettagli su cosa manca quando contatti il supporto.

Consiglio: Se il codice e le impostazioni dell’app sembrano corretti nell’editor ma l’app live mostra ancora schermate vuote o aggiornamenti mancanti, ricontrolla gli schemi dei campi e i dati salvati.

1. Clicca Discuss nella finestra della chat AI prima di iniziare. Il pulsante Discuss dovrebbe essere evidenziato.
2. Pianifica, fai domande e parla delle tue idee con l’IA.
3. Quando hai finito di discutere e sei pronto perché l’IA agisca, clicca Discuss di nuovo per disattivarlo. Il pulsante Discuss non sarà più evidenziato e poi puoi chiedere all’IA di implementare le modifiche.

1. Clicca Visual Edit e Discuss nella chat AI.
2. Clicca l’elemento nell’anteprima dell’app su cui vuoi lavorare, per esempio, un pulsante, form, input o riga di tabella.
3. Clicca Discuss sull’elemento per aprire una chat focalizzata collegata a quel componente.
4. Nella chat AI, spiega cosa sta succedendo e cosa dovrebbe succedere.

1. Clicca l’icona Revert su un messaggio della chat, o torna all’ultima versione funzionante dell’app.
2. Clicca il pulsante Stop nella chat se è bloccato in uno stato come ‘thinking’, ‘applying changes’ o ‘undoing’.
3. Se la richiesta AI è molto lunga o complessa, dividila in parti più piccole e gestibili.
4. Aggiorna il browser e controlla la connessione internet.
5. Svuota cache del browser e disattiva estensioni che potrebbero bloccare gli script.
6. Apri l’app in una finestra privata o in incognito.
7. Se ancora non funziona, controlla Discord per problemi segnalati.
   Se lo stato di elaborazione della chat dura più di 10 minuti o non fornisce aggiornamenti, clicca il pulsante Stop e comunica al team di supporto, includendo questi dettagli:

   • Dove l’IA si è bloccata (posizione o funzione nell’app)
   • Il prompt o l’azione che stavi eseguendo
   • Quanto è durato lo stato di elaborazione

1. Annulla l’ultimo messaggio, come suggerito dall’errore.
2. Aggiorna la pagina completamente:
   • Su Windows o Linux, premi Ctrl + Shift + R o Ctrl + F5.
   • Su Mac, premi Cmd + Shift + R.
3. Prova a svuotare la sezione chat e inizia un nuovo prompt.
4. Se l’errore continua, contatta il supporto e includi dettagli sul prompt e sull’errore.

1. Vai alla Dashboard dell’app.
2. Vai su Settings e poi App settings.
3. Clicca Clone app.
4. Apri l’app clonata.

1. Copia il testo del prompt originale.
2. Crea una nuova app.
3. Incolla lo stesso prompt nella chat AI e riprova.

1. Vai alla dashboard dell’app e clicca Security.
2. Clicca Start security check per scansionare regole RLS mancanti o mal configurate.
3. Rivedi i problemi trovati e clicca Apply Fixes per usare i valori di default sicuri raccomandati, o regola le regole per ogni entità manualmente.
4. Accedi con ruoli utente diversi per confermare che solo le persone autorizzate possono accedere a ogni tipo di dato.

1. Aggiorna la pagina o riprova più tardi, poiché alcuni errori 500 sono temporanei.
2. Controlla la pagina di stato o i canali Discord per vedere se c’è un incidente noto sulla piattaforma.

• Nome della tua app
• Dove e quando si verifica l’errore
• Eventuali messaggi di errore dalla console (screenshot se possibile)
• Quali passaggi hanno portato al problema

• L’app si carica brevemente, poi scompare.
• Cliccando il link dell’app appare solo una pagina bianca o una rotellina.
• Alcune pagine, tab o funzionalità restano bloccate e non responsive.
• L’app va in crash cliccando pulsanti o facendo selezioni.
• Nulla appare provando ad accedere alla dashboard, all’anteprima o alle pagine chiave.

1. Aggiorna la pagina o apri l’app in una nuova finestra del browser.
2. Svuota cache e cookie del browser, poi riprova a caricare.
3. Assicurati che la connessione internet sia stabile.
4. Cambia browser o dispositivo per vedere se il problema persiste.
5. Se hai fatto modifiche recenti prima del problema, prova ad annullare le modifiche più recenti.
6. Aspetta qualche minuto. A volte la piattaforma si sta aggiornando o ha un breve downtime temporaneo.

• Una descrizione di ciò che vedi (es. pagina bianca/spinner)
• Quando è iniziato il problema e le modifiche recenti
• Nome o link dell’app
• Eventuali messaggi di errore mostrati nella console del browser (se possibile)

1. Usa la cronologia versioni per fare il revert velocemente dell’app a prima del prompt bloccato. È il modo più rapido.
2. Cambia l’LLM nelle impostazioni dell’app, passa alla modalità Discuss e invia un prompt qualsiasi (per esempio, “hi”) per interrompere lo stato bloccato.
3. Usa la modalità Visual Edit per fare una piccola modifica—come aggiungere uno spazio o aggiornare un testo—per forzare un cambio di stato.
4. Se possibile, apri l’app su un dispositivo mobile, attiva la modalità Discuss e invia un prompt.

1. Ogni prompt nella cronologia della chat ha un pulsante Revert. Cliccalo per riportare l’app a subito prima di quella modifica.
2. Fare il rollback “chiedendo” all’IA nella chat non annulla mai davvero le modifiche del prompt: solo il pulsante Revert o la cronologia versioni funzionano.
3. Se il pulsante Revert non funziona, usa Version History (di solito vicino alla dashboard o all’anteprima). Ti permette di ripristinare una versione precedente.
4. Se sia Revert che Version History non funzionano, contatta il supporto Base44.

• Il link alla tua app
• Un elenco dei nomi delle funzioni di backend colpite (per esempio, ebayAuth)
• Screenshot che mostrano gli errori 404 a ogni endpoint
• Quando è iniziato il problema, come dopo un deploy, migrazione o aggiornamento della piattaforma

1. Accedere al servizio.
2. Andare alla sezione API o developer.
3. Generare la tua chiave.
4. Incollarla in Base44 come Secret.

• Le richieste GET ti permettono di passare dati nella query string dell’URL.
• Le richieste POST ti permettono di inviare dati in modo sicuro nel corpo della richiesta.

1. Entrypoint Deno.serve mancante: Ogni file di funzione nella cartella /functions deve usare Deno.serve() come entrypoint. Per esempio: Deno.serve((request) => { ... })
2. File di utility o file vuoti in /functions: Moduli di utility o file completamente vuoti nella cartella /functions possono attivare questo errore. I file helper vanno spostati fuori da /functions o esclusi dal deploy.
3. Import non validi: Le funzioni di backend devono essere autonome. Mantieni solo import da pacchetti npm supportati. Non importare:

• Componenti frontend
• Utility condivise di progetto da altre cartelle
• Altre funzioni di backend direttamente

4. API non supportate: Il runtime Deno non supporta alcune built-in di Node.js o API solo per browser. Rimuovi o sostituisci cose come:

• Moduli Node.js come fs, path, process, crypto
• API DOM o basate su window del browser

1. Controlla l’entrypoint: Assicurati che ogni file in /functions deployato come funzione di backend definisca un blocco Deno.serve().
2. Pulisci la cartella /functions
   • Rimuovi o sposta file vuoti o moduli di utility che non dovrebbero essere deployati come funzioni.
   • Assicurati che solo i file di funzione effettivi vivano in /functions.
3. Correggi import e API
   • Rimuovi import locali di componenti frontend, utility condivise o altre funzioni di backend.
   • Sostituisci API Node.js o browser-specifiche non supportate con alternative supportate.
   • Mantieni solo import da pacchetti npm supportati.
4. Salva e pubblica: Salva le modifiche e pubblica l’app così le funzioni di backend possono essere ricostruite e deployate.
5. Chiedi all’IA di Base44 di rifattorizzare la funzione: Se vedi ancora l’errore, copia il codice della funzione nella chat AI e di’: “This backend function returns ISOLATE_INTERNAL_FAILURE. Make it self contained and compatible with Deno.serve without changing what it does.” L’IA può aiutare a riscrivere la funzione seguendo i pattern Deno corretti mantenendo la stessa logica.

1. Vai alla dashboard dell’app.
2. Clicca Publish in alto a destra.
3. Seleziona Publish app se l’app non è ancora pubblicata.

1. Nella dashboard dell’app, clicca Overview.
2. Sotto App visibility, seleziona Public (No login required) o Public (Login required), a seconda di chi deve accedere.
3. Se l’app è impostata su Private (Base44 login required), solo gli indirizzi email invitati esplicitamente possono aprire il link.

1. Se usi un dominio personalizzato invece dell’URL default Base44, assicurati che sia connesso e verificato nelle impostazioni.
2. Prova ad aprire l’URL default direttamente per confermare che l’app si carichi come previsto.

1. Rimuovi eventuali record AAAA (IPv6) per il tuo dominio, poiché possono interferire con la configurazione.
2. Aspetta 48-72 ore per la propagazione completa.
3. Usa uno strumento come whatsmydns.net per confermare che i record aggiornati siano visibili globalmente.
4. Ricontrolla di aver inserito i valori esatti.
5. Se lo stato è ancora pending dopo circa 30 minuti, prova a scollegare il dominio in Base44 e riaggiungerlo.

• Uno screenshot dei record DNS
• Il nome del dominio
• Il link dell’app Base44

1. Apri l’email IONOS e clicca il link per confermare l’indirizzo email.
2. In Base44, vai alla Dashboard dell’app e clicca Domains, seleziona il dominio e clicca Unlink domain.
3. Connetti di nuovo il dominio.
4. Aspetta qualche minuto per il completamento della connessione.

• Assicurati che i record DNS corrispondano esattamente a quanto mostrato nella guida per il tuo tipo di setup.
• Rimuovi qualsiasi record AAAA (IPv6), poiché possono bloccare le connessioni.
• Controlla eventuali refusi. Copia e incolla i valori esattamente dalla guida.
• Assicurati che sia www che il dominio root siano configurati correttamente.
• Conferma che il tuo dominio sia rinnovato e attivo.
• Aspetta fino a 72 ore perché le modifiche abbiano effetto.

• Ricontrolla i requisiti dei record CNAME e ANAME/ALIAS:
  • www → base44.onrender.com (CNAME)
  • root / @ → base44.onrender.com (ANAME/ALIAS o record A se ANAME/ALIAS non è supportato)
  • Se usi il record A, imposta @ → 216.24.57.1
• Rimuovi eventuali record AAAA. Base44 supporta solo IPv4 e i record AAAA possono interrompere la risoluzione del dominio.
• Per i domini IONOS, prova a scollegare e ricollegare il dominio.
• Se hai provato questi passaggi e vedi ancora problemi dopo la propagazione DNS completa, contatta il supporto.

• Verifica che i record DNS del dominio corrispondano esattamente a quanto mostrato nella dashboard Base44.
• Rimuovi eventuali record AAAA (IPv6) dalle impostazioni DNS, poiché possono bloccare connessioni sicure.
• Controlla attentamente refusi o valori mancanti nelle voci DNS.
• Assicurati che sia www che il dominio root puntino ai corretti IP Base44 o CNAME.
• Verifica che la registrazione del dominio sia attiva e sia stata confermata.
• Consenti fino a 72 ore per la propagazione completa di DNS e SSL.
• Se usi un servizio DNS come Cloudflare, aggiorna i record direttamente lì e imposta i record legati a Base44 su DNS only (nuvola grigia) durante la configurazione o risoluzione.

• Uno screenshot dei record DNS correnti
• Il nome del dominio
• Un link all’app Base44

1. Controlla la casella, spam e junk per un’email da IONOS.
2. Se non trovi l’email, contatta IONOS e richiedi una nuova email di verifica.
3. Quando contatti IONOS, fornisci il nome del dominio e spiega che non hai ricevuto l’email dopo l’acquisto.
4. Segui i passaggi da IONOS per completare la verifica del dominio.

1. Apri uno strumento di lookup DNS pubblico e cerca i record A del dominio.
2. Confronta gli IP che vedi con i record A nella zona DNS del registrar e conferma che un IP appare solo nello strumento pubblico.
3. Accedi al tuo account registrar e apri la pagina di gestione del dominio.
4. Cerca sezioni chiamate Domain forwarding, URL redirect, Web forwarding o Parking.
5. Se qualche opzione di forwarding, redirect o parking è attivata per il dominio, disattivala o eliminala, poi salva.
6. Se non sei sicuro da dove viene l’IP extra, copia l’IP dallo strumento DNS ed esegui un lookup WHOIS.
7. Se l’IP appartiene al tuo registrar (come GoDaddy o Namecheap), è quasi certamente una pagina di parking o forwarding di default. Assicurati che tutte le funzioni siano completamente disattivate per questo dominio.
8. Aspetta la propagazione delle modifiche DNS e ricontrolla la connessione o lo stato SSL del dominio.

1. Verifica che il video sia in uno dei formati supportati: MP4, WEBM, MOV, AVI, MKV, M4V, WMV, OGV, 3GP o 3G2.
2. Assicurati che il video sia di 100MB o meno.
3. Prova a caricare di nuovo.
4. Se il caricamento ancora non funziona, aggiorna l’editor e riprova.

1. Verifica che il file sia in uno dei formati supportati.
2. Assicurati che il file non superi il limite di dimensione per quel tipo.
3. Se hai caricato accidentalmente il file sbagliato, clicca Revert sul messaggio.
4. Prova a caricare di nuovo usando un formato supportato.

1. Annulla l’ultimo messaggio, specialmente se il caricamento era nel passaggio precedente.
2. Apri il file in un editor di immagini e risalvalo o esportalo in un formato supportato, come PNG, JPG o JPEG, invece di rinominare solo l’estensione.
3. Verifica che il file rispetti i limiti per la chat AI.
4. Prova a caricare di nuovo l’immagine appena esportata usando un formato supportato.

• Inviare un form con campi obbligatori mancanti.
• Chiamare un’API con il formato dati sbagliato.

• Provare a vedere una pagina dashboard senza aver effettuato l’accesso.
• Chiamare un’API o funzionalità di integrazione con credenziali non valide o token scaduto.

• Provare a modificare impostazioni in un’app a cui non hai accesso.
• Tentare di accedere a dati o pagine limitati dal tuo ruolo o regole RLS.

• Assicurati che l’endpoint del webhook non richieda autenticazione per servizi che non possono inviare credenziali. L’endpoint deve essere pubblico.
• Se vuoi mantenere l’autenticazione per altre integrazioni, imposta una funzione o endpoint separato solo pubblico per questi servizi.

• Inserire un URL errato per l’app o la dashboard.
• Accedere a un file eliminato o spostato.

• Cliccare rapidamente per riconnettere un dominio o ripetere la stessa azione nella dashboard.
• Inviare molte richieste ripetute in breve tempo tramite API, funzioni di backend o automazioni.

• I limiti di frequenza si applicano per persona, quindi la capacità scala con il numero di persone che usano l’app.
• Distribuisci le richieste nel tempo invece di inviarle tutte insieme.
• Usa richieste batch dove l’integrazione lo supporta.
• Aggiungi caching così non chiami lo stesso endpoint per gli stessi dati ripetutamente.
• Aggiungi logica di retry che aspetta un po’ prima di inviare una nuova richiesta dopo una risposta 429.
• Se gli errori 429 appaiono durante l’attività normale, contatta il supporto Base44 con l’ora dell’errore e cosa stavi cercando di fare.

• Vedere una pagina “500 Internal Server Error”.
• Funzionalità che falliscono salvando o caricando dati.