Deploy a Firebase Studio app

The simplest path is pushing the workspace to GitHub:

1. Switch from the Prototyper view to the Code view.
2. Open Source Control (Ctrl/Cmd-Shift-G) and commit your changes.
3. Check .gitignore includes .env, so your Gemini key isn't uploaded.
4. Click “Publish Branch”, authorize GitHub, and create a private repository.

Alternatives: use “Move now” → “Zip and Download” in the workspace, or run npx firebase-tools@latest studio:export PATH, then push the folder to GitHub yourself. To keep your chat history, also zip /home/user/.idx/ai.

The App Prototyping agent builds Next.js apps with Genkit flows that call Gemini. A typical export has:

• dev on port 9002 and genkit:dev scripts for local work, plus the standard build and start. We use build and start, so the 9002 port doesn't matter.
• src/ai/genkit.ts and src/ai/flows/: Genkit runs inside Next.js server code, so there's no separate AI server to deploy.
• apphosting.yaml and .idx/dev.nix: Firebase-only config. Leave them in the repo; we ignore them.

In Studio, your keys lived in .envand App Hosting. Add them in the project's settings on EthioDeploy:

• GEMINI_API_KEY: the Genkit Google AI plugin reads this first (it also accepts GOOGLE_API_KEY or GOOGLE_GENAI_API_KEY). Get a key from Google AI Studio if you don't have one.
• Any NEXT_PUBLIC_FIREBASE_* values your app reads. These are baked in at build time, so add them before the deploy.

Some newer Studio apps hardcode the Firebase config in src/firebase/config.ts and first try initializeApp()with no arguments, which only works on App Hosting. They fall back to the hardcoded config and log an “Automatic initialization failed” warning. The app works; pass the config object directly to remove the warning.

Your Firestore data and Firebase Auth users stay in your Firebase project, and the app keeps talking to them from its new address. Two things to update:

• In the Firebase console, go to Authentication → Settings → Authorized domains and add <project-slug>.ethiodeploy.com and any custom domain. Google sign-in fails on unlisted domains.
• If you use App Check with reCAPTCHA, add the new domain to the reCAPTCHA key's allowed domains.

Studio templates ship next.config.ts with typescript.ignoreBuildErrors: true. The build passes, but type errors are hidden until they break at runtime. Run npm run typecheck locally (or ask the AI coding agent to fix the errors), then turn the flag off.

Placeholder images are loaded from hosts like placehold.co and picsum.photos, listed in images.remotePatterns. Swap them for your own images, and add any new image host there. Everything else in the Next.js guide applies.

1. Sign in with GitHub and install the EthioDeploy app on the repo.
2. Click “New Project” and pick the repo.
3. Watch the build in the dashboard. When the health check passes, your app is live at <project-slug>.ethiodeploy.com. Every push to the default branch redeploys, and the old version keeps serving until the new one is healthy.