Emergent

FAQs

Frequently Asked Questions

What is Emergent?

Emergent is an agentic vibe-coding platform where you describe an app in natural language and AI agents build, test, and publish it for you. You chat with the platform, refine your vision iteratively, and Emergent handles the implementation - front-end, back-end, database, hosting, and published app.

How does the chat-to-published app flow work?

You describe your app idea in the chat interface. Emergent's AI agents interpret your requirements, generate code, provision infrastructure, and publish a working application. You can refine and iterate by continuing the conversation. For a detailed walkthrough, see The chat-to-published app flow.

Do I need to know how to code?

No. Emergent is designed for users of all technical levels. You describe what you want in plain language, and the platform handles the technical implementation. If you do know how to code, you can also provide detailed technical guidance or even paste code snippets to steer the agents.

What types of applications can I build?

Emergent supports a wide range of applications including web apps, mobile apps (iOS and Android via React Native), dashboards, APIs, SaaS tools, MVPs, prototypes, and internal business tools. The platform handles full-stack development with database integration, authentication, payments, and more.

Can I convert a web app to mobile or vice versa?

Yes. Emergent can convert web applications to React Native mobile apps and vice versa. The conversion process preserves your data and core functionality while adapting the UI and navigation patterns for the target platform. See Web to Mobile conversion for details.

What technologies does Emergent use under the hood?

Emergent builds apps using modern, production-ready stacks:

  • Front-end: React, Next.js, Tailwind CSS, shadcn/ui components
  • Mobile: React Native with Expo
  • Back-end: Python/FastAPI or Next.js API routes, REST APIs, running on Emergent's servers
  • Database: MongoDB Atlas (managed, scalable)
  • Hosting: Emergent's infrastructure (emergent.host, Cloudflare) for web; Expo Application Services for mobile
  • Authentication: Emergent Auth, or Auth0, Clerk, and other integrations
  • Payments: Stripe integration

The specific stack may vary based on your app's requirements.

How is my data stored and secured?

Data is stored in a MongoDB Atlas database provisioned for your project (shared cluster by default; a Dedicated Database is a paid upgrade). Each app gets its own isolated database with industry-standard encryption at rest and in transit. You own your data; note that production data export is not currently self-serve, use your own external DB or mongodump from an allowlisted machine after migration. See Database (MongoDB) for more.

Can I use my own API keys or bring my own LLM?

Yes. Emergent provides a Universal LLM Key for convenience, but you can bring your own API keys for OpenAI, Anthropic, Google, or other providers. You can configure per-project LLM preferences and manage keys in your workspace settings.

How do I publish my app to production?

Click Publish to publish your app for the first time (or Re-publish for subsequent publishes). The pipeline takes approximately 10-15 minutes and provisions hosting, configures environment variables, and makes your app live at your <appname>.emergent.host URL. You can also connect a custom domain to your published app.

Why does Emergent say Publish instead of Deploy? Where did the Deploy button go?

Emergent renamed deploying to publishing. Deploy and Redeploy are now Publish and Re-publish, deployments are called publishes, and the panel is Manage Publishing. Only the name changed - the process, your live apps, and your URLs are exactly the same. Older tutorials that say "deploy" still apply; just click Publish.

Can I connect a custom domain to my app?

Yes. Once your app is published, you can connect your own domain name through the workspace settings. Emergent handles DNS configuration and SSL certificate provisioning. See Custom domain for step-by-step instructions.

What happens if I want to iterate or make changes after published app?

Continue the conversation in chat. Describe the changes you want, and Emergent's agents will update the code, re-run tests, and publish the new version. Your database and user data persist across iterations.

Can I export my code and self-host?

On paid plans (Standard and above), you can push your application's source code to GitHub via the Save → Save to GitHub feature. There is no download/archive button; code leaves the platform via GitHub push or by copying from the VS Code view (available on all plans). You can then publish it to any hosting provider you choose.

Does Emergent support authentication and user management?

Yes. Emergent includes Emergent Auth (built-in), which supports email/password, Google sign-in (no extra keys needed), and phone OTP. You can also integrate Auth0, Clerk, or Firebase Auth. Ask the agent to add authentication to your app.

Can I integrate third-party APIs and services?

Absolutely. Tell Emergent which APIs or services you want to integrate (Stripe, Twilio, SendGrid, Google Maps, etc.), and the agents will generate the integration code, handle authentication, and configure environment variables.

How do I manage environment variables and secrets?

Environment variables and secrets are managed through the workspace settings (Preview → Manage → Secrets). You can edit values of existing keys there. To add new keys, ask the agent to add them to .env, then re-publish. Secrets are encrypted and never exposed in the codebase.

What is the workspace and how do I navigate it?

The workspace is your project hub where you can view code, logs, database records, publish history, settings, and more. It provides a visual interface for monitoring and managing your app. See A tour of the workspace for a complete overview.

Can I collaborate with a team on an Emergent project?

Team collaboration features vary by plan. You can invite collaborators to view or edit projects, manage permissions, and work together in the same workspace. Check your plan details for collaboration limits.

What are the pricing plans and limits?

Emergent offers multiple pricing tiers with different quotas for projects, published versions, compute, storage, and team members. Visit the Emergent pricing page or your account dashboard for the latest plan details and limits.

How do I upgrade or downgrade my plan?

You can change your subscription tier at any time from the billing section of your account settings. Upgrades take effect immediately; downgrades apply at the end of the current billing cycle.

What happens if I hit a usage limit?

If you reach a plan limit (projects, API calls, storage, etc.), you'll receive a notification. Depending on the limit, the platform may pause certain operations until you upgrade or the next billing cycle begins. Critical functionality like accessing your code and data remains available.

Can I cancel my subscription at any time?

Yes. You can cancel your subscription from the billing settings. Your access continues until the end of the current billing period, after which your account transitions to the Free plan.

What support options are available?

Support options depend on your plan. All users have access to documentation, in-app live chat (Emmy, primary/fastest), Discord community, and email support at support@emergent.sh.

Higher-tier plans may include priority support or forward published engineers.

How do I report a bug or request a feature?

Use the feedback widget in the workspace, or contact support via email at support@emergent.sh. Feature requests are tracked and prioritized based on user demand. You can also join the Emergent community to vote on and discuss upcoming features.

Is there a limit to how many times I can iterate on an app?

Iteration limits depend on your plan. Most plans allow unlimited iterations within reasonable usage bounds. Compute-intensive operations (like full re-builds) may count toward usage quotas.

Can I build apps in languages other than English?

Yes. Emergent supports natural-language input in multiple languages. You can describe your app in your preferred language, and the platform will generate code and content accordingly.

Does Emergent support internationalization (i18n) in apps?

Yes. You can request multi-language support for your app, and Emergent will generate i18n-ready code with locale management, translation keys, and language switchers.

What testing does Emergent perform on my app?

Emergent's agents run automated tests during the build process, including unit tests, integration tests, and basic end-to-end smoke tests. You can also request additional test coverage or specific testing scenarios.

Can I access the database directly?

You can query and manage your MongoDB database through the Database Manager in the workspace interface. External MongoDB client connections are not supported, the managed cluster rejects external connections. All browsing and editing must be done via the Database Manager (note: it edits live data with no undo).

How do I back up my database?

The platform manages backups automatically. There is no Atlas console access for configuring additional backup policies. You can migrate your data to your own external database using the manual runbook (export → import → allowlist Emergent's egress IPs → update MONGO_URL/DB_NAME → re-publish) if you need more control.

What happens to my data if I delete a project?

Deleting a project permanently removes the codebase, database, and all associated resources. This action cannot be undone. Always export your code and data before deletion.

Can I import an existing codebase into Emergent?

Yes. You can import an existing codebase when starting a new job, connect your GitHub account (OAuth), provide a public URL, or ask the agent. Note that importing is only available at new-job creation; there is no mid-job pull or in-platform sync.

Does Emergent support mobile app store published app?

Yes. For React Native apps, Emergent integrates with Expo Application Services (EAS) to build and submit apps to the Apple App Store and Google Play Store. You'll need developer accounts with Apple and Google.

How do I handle app updates after publishing to app stores?

Continue iterating in Emergent as usual. When you're ready to release an update, Emergent can rebuild and submit the new version through EAS. You control the release schedule and versioning.

What are the system requirements for using Emergent?

Emergent is a cloud-based platform accessible via any modern web browser (Chrome, Firefox, Safari, Edge). No local installation or specific hardware is required. For mobile app testing, you can use simulators (included) or physical devices.

Can I use Emergent offline?

No. Emergent is a cloud platform that requires an internet connection for the AI agents to build, test, and publish your apps.

Where can I learn more about Emergent-specific terminology?

See the Glossary of Emergent terms for definitions of platform-specific concepts like agents, vibes, canonical builds, and more.

How does Emergent handle versioning and rollbacks?

Emergent maintains a publish history in the workspace. You can view past versions and roll back to one of up to 3 previous images if needed. Each published app is tagged with a timestamp.

Each published app is tagged with a changelog.

Can I schedule published versions or automate workflows?

Advanced automation features (like scheduled published versions or CI/CD integrations) may be available on higher-tier plans or through API access. Check your plan details or contact support for specifics.

What happens if an agent makes a mistake or breaks my app?

Emergent agents are designed to test and validate changes before published app. If an issue occurs, you can roll back to a previous version, describe the problem in chat, and the agents will attempt to fix it. You can also manually edit code in the workspace.

Is my intellectual property protected?

Yes. You retain full ownership of the applications and content you create with Emergent. Emergent does not claim ownership of your ideas, code, or data.

Does Emergent comply with data protection regulations (GDPR, etc.)?

Emergent follows industry best practices for data security and privacy. For specific compliance questions or data processing agreements, contact the Emergent legal or support team.

Can I white-label or resell apps built on Emergent?

Yes. You own the apps you build and can white-label, resell, or commercialize them as you see fit. Check your plan's terms of service for any restrictions.


Still have questions?

If your question isn't answered here, check the rest of the documentation or reach out to Emergent support. We're here to help you succeed.


Common questions by topic

Prompting

Why doesn't pasting my ChatGPT plan/spec produce what I expect?

An external spec written for another tool often doesn't map to Emergent's build flow. Emergent works best when you describe features conversationally and let the agent ask clarifying questions, rather than dropping in a large pre-written plan. Break the plan into smaller feature requests and iterate.

How should I phrase prompts to get better results?

Small, concise feature requests beat mega-prompts, they lower credit burn and reduce confusion. Describe one capability at a time, answer the agent's clarifying questions (Universal Key vs your own key, auth, design preferences), and refine step by step.

Models & agent quality

What is the difference between E1, E2, E3 and the underlying models?

E1, E2 and E3 are Emergent's agent tiers (different workflows), chosen from the agent dropdown at job creation; the LLM is a separate model selector. They differ in capability and cost, higher tiers apply more reasoning to complex work. Pick the tier that matches how hard your task is.

What is Maxx mode and how does it affect credit consumption?

Maxx mode (Pro-only) runs the agent at higher effort for tougher tasks and, as a result, consumes significantly more credits. Use it when standard runs get stuck.

Credits

How are credits deducted and what makes an app consume more?

Credits are consumed by generation, testing, cloud publishes and integrations. App complexity and Maxx mode drive higher usage.

How much does a single prompt cost in credits?

It varies with the work the agent does. You can set a limit to cap consumption so a single prompt can't run away.

Do my credits expire? When do they reset?

Monthly subscription credits do not roll over, they refill to the cap at each billing cycle. Purchased top-up credits never expire. Promotional/boost credits carry a shown expiry date. Free tier users receive 10 credits on their first day.

What happens if I run low on credits mid-prompt?

The build pauses when credits run out; top up to continue. A published app charge can take an already-at-or-below-zero balance negative; jobs pause at zero and there is no separate renewal takedown threshold.

What are the different types of credits (Universal Key vs Emergent credits)?

Emergent Credits pay for building on the platform. The Universal LLM Key uses Emergent Credits to call GPT / Claude / Gemini without setting up your own API key. You can top up either at any time, just don't confuse the two.

Plans

What is the difference between Standard and Pro?

The Free plan provides daily credit grants (10 on day one) but cannot publish. Standard and Pro differ in included credits and features; Pro adds more capability. See the Plans & billing pages for the current breakdown.

Which publishing plan do I need (how much CPU/memory)?

Publishing tiers are Starter, Launch, Grow, Scale, and Elite, each a fixed monthly credit fee with increasing CPU/memory. Pick the tier that matches your app's resource needs; you can move up if it runs hot.

Prompt windows

Which prompt window should I use - Fullstack, Mobile, Landing page, or Brainstorm?

Use Fullstack Builder for full web apps, Mobile App for native iOS/Android apps, Landing Page for marketing pages, and Brainstorm to plan an idea before building. See "Compare the 4 windows".

What are the limitations specific to each job type (mobile vs web)?

A native Mobile App runs on a different stack underneath, it is not a web URL in a wrapper, which changes its domain, bundle-ID and publishing behaviour. Web apps publish to a URL and use re-publish/replace.

Mobile

What is the difference between a native mobile app and a web URL?

A native app is compiled for iOS/Android and installed from the app stores; a web app is a URL you open in a browser. Native apps have no domain attached.

Is there a step-by-step guide to publish to the Play Store / App Store?

Yes. Preview and test on-device, generate a build, then publish to the stores. See the mobile publishing guide for the per-platform steps and review timelines.

What are package name, bundle ID and app ID - and why can't I change them after the first build?

They identify your app to Android (package name) and iOS (bundle ID). They are generated at the first build/publish and locked afterwards, so plan them before your first build.

Why did my integration (e.g. Apple Music) break after publishing?

An integration must use the same bundle ID as your app. If the bundle ID configured with the provider doesn't match your app's, the integration breaks.

Web ↔ Mobile

Will I lose data or functionality when converting between web and mobile?

Converting adapts the UI and navigation for the target platform while preserving your data and core functionality. Mobile uses the same backend database as your web app.

Custom domain

My custom domain is stuck / not loading - how do I fix it?

Most cases are a DNS fix: add an A record pointing to the Emergent IP shown in the Custom Domain flow, plus a CNAME www entry with your domain value. Give DNS time to propagate. (Web apps only.)

Do I need a custom domain for a mobile app?

No. Native mobile apps have no domain attached, so there's nothing to buy.

What is the emergent subdomain (www.app...) and will it work?

Every web app gets a built-in Emergent subdomain (<appname>.emergent.host) that works as-is. Default subdomains cannot be renamed. A custom domain is optional, add one when you want your own branded URL.

Changing your app's name

Can I change the name of my app on the emergent domain?

The default Emergent subdomain (<appname>.emergent.host) cannot be changed. To use a different name, add a custom domain; the built-in subdomain itself is fixed.

Google auth shows "login to xyz" but I want it to say something else - why?

That consent-screen name comes from the OAuth app configured with Google, not from Emergent. Update the app name in your Google OAuth (Google Cloud) credentials and the screen will follow.

Published app

What is the difference between re-publish and replace published app?

Re-publish (Re-publish) pushes your latest code to the live app free of charge and picks up any new environment variable keys added to .env. Replace pushes code and can also swap the production database.

Why does my database only change when I use "replace"?

Re-publish keeps your existing production database untouched. The production database only changes when you Replace, which is why replace affects your data.

Why don't my preview changes show up in my published app?

Preview and published app are separate environments. Changes you make in preview don't propagate to the live app until you re-publish or replace.

I saved my secret but nothing changed - what did I miss?

Saving a secret isn't enough. A saved secret only takes effect in a published app after you Re-publish (re-publish).

I added a new secret/env variable - why isn't it taking effect?

New environment variables must be added to .env via the agent and then picked up by a re-publish (Re-publish). An ordinary re-publish will pick up new .env keys.

How do I migrate my live database to my own external database?

Migrating to your own database is a manual process: export your data, import it into your own Atlas instance, allowlist Emergent's egress IPs, update the MONGO_URL and DB_NAME system keys, then re-publish. There is no automatic background sync or cutover.

Is row-level security (RLS) available on MongoDB?

MongoDB doesn't offer Postgres-style row-level security. Enforce per-user access rules in your app's API/query layer (scope every query to the authenticated user).

GitHub

How do I pull code from GitHub?

Use Save → Save to GitHub (Standard plan and above) and clone locally. If you later re-import or let the agent work over pulled code, note the agent may change core files, keep a backup first.

I pushed to GitHub and my .env / credentials were exposed - how do I prevent this?

Never commit secrets. Keep them in the Secrets manager, make sure .env is git-ignored before you Save to GitHub, and if anything leaked, rotate those keys at the provider immediately.

Integrations

How do I set up a third-party API - auth and keys?

Ask the agent to add the integration, then store the API keys in the Secrets manager (never in code or GitHub) and re-publish so the published app picks them up.

Security & privacy

Where is my data stored? Is it private?

Your data is processed and stored in the United States and India, access is limited, and it's governed by our DPA. Per-vendor processing locations are listed at app.emergent.sh/subprocessors. See Data, Trust & Support → Where your data is stored.

How does Emergent handle data leakage concerns?

Each app has its own database and published app, and your data isn't used to train AI models (DPA 12.1). The main thing to manage on your side is secrets, keep them in the Secrets manager, never in GitHub. See Data isolation & leakage.

Do you have a signed Data Processing Agreement (DPA)?

Yes, it's self-executing and published at app.emergent.sh/dpa. It forms part of our Terms of Service, so no separate signature is needed. See Data Processing Agreement (DPA).

How do I delete my account or erase all my personal data?

Delete a single project via Settings → Danger Zone (permanent). Delete your whole account via Account Settings (cancels the subscription, removes published versions, reversible within the window). Within 45 days of termination you may instruct return or deletion of your personal data (DPA 14.3). See Deletion & retention.

Where is my data stored, and can I get EU-only hosting?

Data is stored in the US and India. EU-only hosting is not available self-serve, contact privacy@emergent.sh for feasibility and timing.

Platform

What is Emergent's uptime / where can I check platform status?

Check current platform status at the Trust Centre: emergent.trust.site.