# Vibely

> Build production web and mobile apps by describing them. Guides, integrations, and the API reference for Vibely.

- [Welcome to Vibely](https://docs.vibely.sh/introduction/welcome.md): Vibely builds, iterates on, and publishes web apps and native iOS and Android apps from natural language, with real code you own.
- [Create an account](https://docs.vibely.sh/introduction/create-account.md): Create your Vibely account with Google or email, finish the short setup, and land on the dashboard ready to build.
- [Quick start](https://docs.vibely.sh/introduction/quickstart.md): Build and publish your first Vibely app in about ten minutes, from your first prompt to a live URL you can share.
- [Dashboard overview](https://docs.vibely.sh/introduction/dashboard.md): Find your way around the Vibely dashboard: start new projects, reopen existing ones, switch workspaces, and reach your settings.
- [Vibely for Enterprise](https://docs.vibely.sh/introduction/enterprise.md): Run Vibely across an organization with centralized identity, workspace governance, audit logs, private packages, and terms set on a signed Order.
- [Vibely MCP server](https://docs.vibely.sh/integrations/vibely-mcp-server.md): Build, edit, inspect, and publish Vibely web and mobile apps from Claude, ChatGPT, Cursor, Claude Code, Codex, and any other MCP client.
- [Projects in Vibely](https://docs.vibely.sh/features/projects/overview.md): What a project is in Vibely and how to work with one, from creating and organizing projects to sharing, publishing, and deleting them safely.
- [Find your way around the editor](https://docs.vibely.sh/features/projects/editor.md): A guided map of the Vibely editor, from the chat panel and live preview to the header controls, the Manage panel, and keyboard shortcuts.
- [Work with Vibely in the project chat](https://docs.vibely.sh/features/projects/chat.md): Everything you can do in the project chat, from writing prompts and attaching files to planning, queueing follow-ups, answering questions, and fixing errors.
- [Preview and test your app](https://docs.vibely.sh/features/projects/preview.md): Use the live preview to watch changes land, click through your app, check it at different screen sizes, and edit it directly with the preview toolbar.
- [View and edit your project's code](https://docs.vibely.sh/features/projects/code-editor.md): Browse the real code Vibely writes for your app, watch files change as Vibely works, edit and delete files yourself, point Vibely at exact files, and download your whole codebase.
- [Undo and restore with version history](https://docs.vibely.sh/features/projects/history.md): How Vibely saves a version after every change, and how to roll your project back from an error card, by editing a message, or from Version history.
- [Project settings](https://docs.vibely.sh/features/projects/settings.md): Where to find a project's settings and what each one does, from its name and access to public remixing, knowledge, domains, Git, and deleting the project.
- [Remix a project](https://docs.vibely.sh/features/projects/remix.md): Make your own independent copy of a project, control who can remix yours, and know exactly what a copy includes and what it leaves behind.
- [Find and search projects](https://docs.vibely.sh/features/projects/projects-and-folders.md): Find any project fast with the command palette, the sidebar, and the search, filters, and sorting on your projects list.
- [Implement changes in Build mode](https://docs.vibely.sh/features/agent/build-mode.md): Build mode is the default way Vibely works. Describe a change and Vibely makes it in your project, and it answers questions without touching your code.
- [Plan a change in Plan mode](https://docs.vibely.sh/features/agent/plan-mode.md): Plan mode investigates your project and writes a plan you can review, edit, and approve before any code is written.
- [Subagents](https://docs.vibely.sh/features/agent/subagents.md): Subagents help Vibely investigate larger tasks by splitting research and code exploration into focused, read-only investigations that run in parallel.
- [Define workspace and project knowledge](https://docs.vibely.sh/features/context/knowledge.md): Give Vibely persistent instructions with workspace knowledge and project knowledge, such as coding standards, architecture rules, and project context it remembers on every message.
- [Define reusable instructions with skills](https://docs.vibely.sh/features/context/skills.md): Package focused instructions, playbooks, and checklists as workspace skills that Vibely applies when a matching task comes up, in every project in your workspace.
- [Reference other projects in your workspace](https://docs.vibely.sh/features/context/cross-project-referencing.md): Reuse code, components, and patterns from other projects in your workspace instead of rebuilding them.
- [Edit from the preview](https://docs.vibely.sh/features/design/visual-edits.md): Select elements, edit text inline, draw on the page, and leave comments directly on your app preview.
- [Design guidance](https://docs.vibely.sh/features/design/design-guidance.md): Pick from three design directions rendered for your product before Vibely builds, and steer color, type, and layout when you want a specific look.
- [Workspace templates](https://docs.vibely.sh/features/design/workspace-templates.md): Publish one of your projects as a workspace template so new projects start from its full codebase, design, and structure.
- [Design systems](https://docs.vibely.sh/features/design/design-systems.md): Attach a design system to a web project so Vibely builds with a fixed palette, type, component list, and set of design rules.
- [Bring Figma designs into Vibely](https://docs.vibely.sh/integrations/figma.md): Two ways to build from your Figma work in Vibely, connect Figma so Vibely reads your files live, or upload a .fig file.
- [Build from an existing website](https://docs.vibely.sh/features/design/build-from-url.md): Point Vibely at a site you have the rights to use, and it builds from that page's real assets, design tokens, and layout.
- [Web App Mode](https://docs.vibely.sh/features/web-apps/overview.md): Build full-stack web applications from natural language
- [Build your first web app](https://docs.vibely.sh/features/web-apps/quickstart.md): From prompt to live preview in 5 minutes
- [Web app templates](https://docs.vibely.sh/features/web-apps/templates.md): What ships in vibely-web and how to extend it
- [Iterate](https://docs.vibely.sh/features/web-apps/iterate.md): Make changes without breaking what works
- [Mobile App Mode](https://docs.vibely.sh/features/mobile-apps/overview.md): Build native iOS and Android apps with Expo from a single prompt
- [Build your first mobile app](https://docs.vibely.sh/features/mobile-apps/quickstart.md): Prompt → web preview → Expo Go on your phone in under 10 minutes
- [Mobile app templates](https://docs.vibely.sh/features/mobile-apps/templates.md): What ships in vibely-expo
- [Native capabilities](https://docs.vibely.sh/features/mobile-apps/native.md): Camera, push, biometrics, geolocation, secure storage, deep links
- [Authentication in mobile apps](https://docs.vibely.sh/features/mobile-apps/auth.md): Native OAuth with a scheme redirect, Sign in with Apple, and the dev-vs-prod trap that only shows up in production
- [Ship to stores](https://docs.vibely.sh/features/mobile-apps/ship.md): EAS builds, TestFlight, Play Console — from button click to live in the store
- [App Store optimization](https://docs.vibely.sh/features/mobile-apps/aso.md): The store listing fields that decide whether anyone finds your app
- [Add a backend with Supabase](https://docs.vibely.sh/integrations/supabase.md): Connect your own Supabase project to give your app a Postgres database, user sign-in, file storage, realtime, and Edge Functions.
- [Add users and authentication](https://docs.vibely.sh/features/backend/auth.md): Add sign-up and sign-in to your app with Supabase Auth, choose sign-in methods, and set the redirect URLs your published app needs.
- [Store API keys with secrets](https://docs.vibely.sh/features/backend/secrets.md): Store API keys and other sensitive values as encrypted project secrets that your Supabase Edge Functions read at runtime, and learn what belongs in .env instead.
- [Add AI features to your app](https://docs.vibely.sh/features/backend/ai.md): Add chatbots, summaries, image and video generation, search, and voice to your app with Vibely AI. No provider API keys required.
- [Test and verify your app](https://docs.vibely.sh/features/testing/overview.md): What Vibely checks automatically after every change and every publish, and the browser testing you can ask for when a flow needs a click-through.
- [Project security view](https://docs.vibely.sh/features/security/project-view.md): Scan a project for vulnerabilities, review findings by severity, fix them from the chat, and control what can block a publish.
- [Security best practices for Vibely apps](https://docs.vibely.sh/features/security/best-practices.md): How to write secure Vibely apps, covering the client bundle, Supabase Edge Functions, row-level security, secrets, authentication, and native builds.
- [Use npm packages](https://docs.vibely.sh/features/build/npm-packages.md): Add charts, drag-and-drop, animations, and other features by asking Vibely to install npm packages into your project.
- [Build secrets](https://docs.vibely.sh/features/build/build-secrets.md): Store encrypted, workspace-level values that Vibely makes available while your projects install packages and build, such as npm tokens for private registries.
- [Managed registry](https://docs.vibely.sh/features/build/managed-registry.md): Publish private npm packages to a registry hosted inside your Vibely workspace and install them in your workspace's projects.
- [Connect tools, services, and APIs](https://docs.vibely.sh/integrations/connectors/overview.md): Connect Vibely to the tools you already use, either as app connectors your published app calls or as chat connectors the agent reads while it builds.
- [App and chat connectors](https://docs.vibely.sh/integrations/connectors/catalog.md): Browse the connector catalog, connect a tool once, and use it in your published app or in the chat while the agent builds.
- [Connector authentication and credentials](https://docs.vibely.sh/integrations/connectors/auth.md): How connectors sign in, where their credentials are stored, and how to let each user of your app connect their own account.
- [Built-in integrations](https://docs.vibely.sh/integrations/connectors/native.md): Supabase, Vibely AI, Stripe, and RevenueCat are wired deeper than a regular connector, and the agent has its own tools for research and images.
- [Connect a custom MCP server](https://docs.vibely.sh/integrations/connectors/custom-mcp.md): Connect any remote MCP server as a chat connector so the agent can use your internal tools, private APIs, and data sources while it builds.
- [Add a third-party analytics tool](https://docs.vibely.sh/integrations/connectors/analytics.md): Vibely shows built-in visitor analytics for published web apps; ask the agent when you also want a product analytics tool such as PostHog, Google Analytics 4, or Amplitude.
- [Manage connectors in your workspace](https://docs.vibely.sh/integrations/admin-controls.md): Decide who in your workspace can connect connectors, which chat connectors the agent may use, and whether it may write through them.
- [Accept payments with Stripe](https://docs.vibely.sh/integrations/stripe.md): Add one-time payments and subscriptions to your app with Stripe Checkout on web and PaymentSheet on mobile.
- [Sell in-app purchases with RevenueCat](https://docs.vibely.sh/integrations/revenuecat.md): Add subscriptions and in-app purchases to your iOS and Android app through Apple and Google, with no billing backend of your own.
- [Connect your app to Notion](https://docs.vibely.sh/integrations/notion.md): Let your published app read and write Notion pages and databases, or let Vibely read your Notion docs while you build.
- [Connect your app to Linear](https://docs.vibely.sh/integrations/linear.md): Let your published app read and create Linear issues, or let Vibely build features straight from your Linear tickets.
- [Build from your Miro boards](https://docs.vibely.sh/integrations/miro.md): Connect Miro so Vibely can read your boards, flows, and sticky notes while you build, and turn them into working screens.
- [Sync your project code with GitHub](https://docs.vibely.sh/integrations/git-sync.md): Git sync keeps your Vibely project in a GitHub repository you own with automatic two-way sync, so you can back up code, collaborate with developers, work in your IDE, and deploy anywhere.
- [Sync your project with GitHub](https://docs.vibely.sh/integrations/github.md): Install the Vibely GitHub App, link a project to a new repository, and keep your code in two-way sync with GitHub.
- [Collaborate on a project](https://docs.vibely.sh/features/collaboration/overview.md): Invite teammates to one project or to your whole workspace, assign roles, and see who is building with you.
- [Share a project with internal or external collaborators](https://docs.vibely.sh/features/collaboration/sharing.md): Invite collaborators, share an invite link, control who can open the project, and send a preview link for review.
- [Project comments](https://docs.vibely.sh/features/collaboration/comments.md): Pin feedback to a spot in the live preview, discuss it in a thread, and send it to Vibely to fix.
- [How Vibely hosts your app](https://docs.vibely.sh/features/deploy/hosting.md): Vibely hosts your published app for you: no servers to set up, HTTPS included, and delivery from locations around the world.
- [Publish your Vibely project](https://docs.vibely.sh/features/deploy/publish.md): Deploy your app to a live URL, choose who can see it, review security, and push updates whenever you are ready.
- [Connect a custom domain](https://docs.vibely.sh/features/deploy/custom-domain.md): Serve your published app on a domain you own: add it, set the DNS records, and go live with free HTTPS.
- [Publish apps with branded URLs](https://docs.vibely.sh/features/deploy/branded-urls.md): Give every app in your workspace a consistent, branded address on vibelyagent.com.
- [Deployment, hosting and ownership options](https://docs.vibely.sh/features/deploy/ownership.md): You own your code and your data. See what Vibely runs for you, what you would run yourself, and how to move parts of your stack.
- [Deploy and host outside Vibely](https://docs.vibely.sh/features/deploy/external-hosting.md): Get your code out of Vibely with GitHub sync or a ZIP download, then deploy the web app to your own Cloudflare account or another platform.
- [Optimize your app for SEO and AI search](https://docs.vibely.sh/features/grow/seo.md): Get your app found on Google and Bing, and quoted by AI search engines like ChatGPT, Perplexity, Claude and Gemini.
- [Project analytics](https://docs.vibely.sh/features/grow/analytics.md): Track visitors, pageviews, bounce rate, visit duration, traffic sources, devices and countries for your published app.
- [Add payments to your app](https://docs.vibely.sh/features/grow/payments.md): Charge for your app: Stripe for web checkout and subscriptions, RevenueCat for in-app purchases on iOS and Android.
- [Publish your app as an MCP server](https://docs.vibely.sh/features/grow/agent-integrations.md): Turn a published Vibely web app into an MCP server that ChatGPT, Claude, Cursor and other AI assistants can connect to.
- [Monitor your live app](https://docs.vibely.sh/features/grow/monitoring.md): See the errors your visitors hit, get notified when something breaks, and hand it to Vibely to fix.
- [Vibely workspace](https://docs.vibely.sh/features/workspace/overview.md): Manage your team's projects, members, billing, and settings in one place.
- [Workspace admin settings](https://docs.vibely.sh/features/workspace/admin-settings.md): Every section of workspace Settings, what it controls, who can change it, and which plan it needs.
- [Workspace Insights](https://docs.vibely.sh/features/workspace/insights.md): Find the projects in your workspace that need a security review first, ranked by findings, publish status, ownership, and activity.
- [Manage workspace members from the People page](https://docs.vibely.sh/features/workspace/people.md): Invite members, change roles, handle access requests, and set per-member credit limits.
- [Groups](https://docs.vibely.sh/features/workspace/groups.md): Organize workspace members into groups to share projects and restrict published apps to specific teams.
- [Manage workspace identity and user provisioning](https://docs.vibely.sh/features/workspace/identity.md): Verify your email domain, connect single sign-on, and control how people from your company join the workspace.
- [Set up workspace single sign-on (SSO)](https://docs.vibely.sh/features/workspace/sso.md): Connect Okta, Microsoft Entra ID, Auth0, or any OIDC or SAML 2.0 provider so your team signs in to Vibely with company credentials.
- [Set up SCIM user provisioning](https://docs.vibely.sh/features/workspace/scim.md): Create, update, and remove workspace members automatically from Okta, Microsoft Entra ID, or any SCIM 2.0 identity provider.
- [Privacy & security settings](https://docs.vibely.sh/features/workspace/privacy-security.md): Workspace-wide controls for member access, publishing, sharing, abandoned projects, MCP, sensitive data, and AI training.
- [Workspace security center](https://docs.vibely.sh/features/workspace/security-center.md): Monitor your workspace security posture, scan results, dependencies, secrets, scheduled scans, and audit logs across every project.
- [Account settings](https://docs.vibely.sh/features/account/settings.md): Manage your profile, sign-in methods, devices, notifications, and account deletion.
- [Delete your account](https://docs.vibely.sh/features/account/deleting.md): Permanently delete your Vibely account, the workspaces you own, and your projects.
- [Subscription plans](https://docs.vibely.sh/features/account/plans.md): Compare Vibely plans and credit tiers, and learn how to upgrade, change, or cancel your plan.
- [Credits and usage](https://docs.vibely.sh/features/account/credits.md): How Vibely credits work, what uses them, how to check your usage, and how to add more.
- [From idea to the App Store](https://docs.vibely.sh/guides/from-idea-to-store.md): One mobile app carried end to end — Streakly, a habit tracker, from a one-line idea to a listing under review
- [Start a build from outside Vibely](https://docs.vibely.sh/guides/build-from-chat.md): Shareable build links, the build stream API, and MCP in both directions: Vibely as an MCP server and as an MCP client
- [Prompting](https://docs.vibely.sh/prompting/best-practices.md): How to shape a prompt so the agent builds what you meant the first time
- [Prompt library](https://docs.vibely.sh/prompting/library.md): Copy-paste prompts for the features people build most, with a mobile variant for every one
- [Debugging](https://docs.vibely.sh/prompting/debugging.md): Report a bug so it gets fixed on the first turn, and unstick a build that has gone in circles
- [FAQ](https://docs.vibely.sh/faq.md): Answers to common questions about building apps, managing projects and your account, security, and how Vibely works.
- [Glossary](https://docs.vibely.sh/glossary.md): Definitions of the Vibely terms and general development concepts used throughout the docs.
- [Build Mode Overview](https://docs.vibely.sh/reference/engine/overview.md): How Vibely turns a natural-language prompt into a running web or mobile app
- [Agent Loop](https://docs.vibely.sh/reference/engine/agent-loop.md): The single while loop that drives every build session
- [Tools](https://docs.vibely.sh/reference/engine/tools.md): The tool registry — what the agent can do inside the sandbox
- [Sandbox](https://docs.vibely.sh/reference/engine/sandbox.md): Cloud sandboxes that run the user app while the agent edits it
- [Streaming](https://docs.vibely.sh/reference/engine/streaming.md): How agent output reaches the client — SSE, WebSocket, and queue mode
- [MCP Client Overview](https://docs.vibely.sh/reference/mcp/overview.md): Connect external MCP servers to the Vibely build agent
- [Connecting MCP Servers](https://docs.vibely.sh/reference/mcp/connection.md): Configure MCP server connections for the build agent
- [MCP Tools](https://docs.vibely.sh/reference/mcp/tools.md): Tools the build agent gains when MCP servers are connected
- [External MCP Servers](https://docs.vibely.sh/reference/mcp/external-servers.md): Reference for connecting popular MCP servers
- [API Overview](https://docs.vibely.sh/api-reference/overview.md): REST API endpoints for Vibely
- [Build Stream](https://docs.vibely.sh/api-reference/vibe-stream.md): POST /api/v1/vibe/stream — build web and mobile apps
- [MCP Servers API](https://docs.vibely.sh/api-reference/mcp-servers.md): Manage external MCP server connections
- [API authentication](https://docs.vibely.sh/api-reference/auth.md): API authentication via Supabase JWT
- [Error Format](https://docs.vibely.sh/api-reference/errors.md): Standardized API error response format
- [Changelog](https://docs.vibely.sh/changelog.md): What shipped on Vibely — new features, improvements and fixes


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.