# vly.ai

> Build software by describing it in plain English. vly.ai is the YC F24-backed AI app builder — React + Vite + Convex + Tailwind + shadcn, powered by Claude Code, OpenAI Codex, and Gemini CLI agents.

## Docs

- [Build software by describing it](https://vlyai-1c28d863.mintlify.app/index.md): vly.ai turns plain English into production React + Convex apps. Backed by Y Combinator (F24), powered by Claude Code, OpenAI Codex, and Gemini CLI.
- [What is vly.ai?](https://vlyai-1c28d863.mintlify.app/getting-started/what-is-vly.md): vly.ai is a YC F24-backed AI app builder. Describe software in plain English; vly returns a deployed React + Convex application with auth, data, and a custom domain.
- [How vly works](https://vlyai-1c28d863.mintlify.app/getting-started/how-vly-works.md): The four-step loop — describe, plan, code, deploy — and what's happening at each step. The mental model to make sense of everything else.
- [Quickstart](https://vlyai-1c28d863.mintlify.app/getting-started/quickstart.md): From signup to a deployed app in five minutes. The fastest path to a working vly project.
- [Build your first app](https://vlyai-1c28d863.mintlify.app/getting-started/first-app.md): An end-to-end walkthrough — from prompt to deployed product. We build a real, simple SaaS together: a team task tracker.
- [Glossary](https://vlyai-1c28d863.mintlify.app/getting-started/glossary.md): Plain-English definitions of every vly term — agent, plan mode, prompt, revision, workspace, project, deployment, and more.
- [FAQ](https://vlyai-1c28d863.mintlify.app/getting-started/faq.md): Answers to the most common questions about vly.ai — what it builds, what it doesn't, pricing, exporting, and how it compares.
- [Plans & pricing](https://vlyai-1c28d863.mintlify.app/getting-started/plans-and-pricing.md): Free, Pro, Business, and Enterprise — what's in each tier, what counts toward usage, and how to upgrade or downgrade.
- [Account setup](https://vlyai-1c28d863.mintlify.app/getting-started/account-setup.md): Sign up, verify your email, customize your profile, and configure workspace defaults.
- [Video tutorials](https://vlyai-1c28d863.mintlify.app/getting-started/video-tutorials.md): Watch vly in action. Short, focused video walkthroughs for the most common workflows.
- [System requirements](https://vlyai-1c28d863.mintlify.app/getting-started/system-requirements.md): What you need to use vly — supported browsers, internet bandwidth, optional tools, and platform-specific notes.
- [How vly compares](https://vlyai-1c28d863.mintlify.app/getting-started/compare.md): An honest, side-by-side look at vly vs Lovable, v0, Bolt, and Replit Agent. Where vly wins, where it doesn't, and how to pick the right tool for the job.
- [Building with vly](https://vlyai-1c28d863.mintlify.app/building/overview.md): The day-to-day workflow — agent mode, plan mode, code mode, iteration, version history, and collaboration.
- [Describing your app](https://vlyai-1c28d863.mintlify.app/building/describing-your-app.md): The structure of a good first prompt. The five-layer method, applied to project initialization, with worked examples.
- [Agent mode](https://vlyai-1c28d863.mintlify.app/building/agent-mode.md): The default mode for vly. Describe a change; the agent decides what to edit, plans implicitly, and writes code. Best for most everyday work.
- [Plan mode](https://vlyai-1c28d863.mintlify.app/building/plan-mode.md): Agent mode with a deliberate review step. Plan mode shows you what the agent intends to do before writing code — the cheapest way to catch a misunderstanding.
- [Code mode](https://vlyai-1c28d863.mintlify.app/building/code-mode.md): Hand-edit code directly in the in-browser editor. The right mode for tiny tweaks where a prompt is overkill.
- [Visual edits](https://vlyai-1c28d863.mintlify.app/building/visual-edits.md): Click directly on UI elements to edit them. Skip the round-trip when you can point at the thing you want to change.
- [Iterating effectively](https://vlyai-1c28d863.mintlify.app/building/iterating.md): Patterns for making 50 small changes a day in vly without losing momentum. The mindset, the rhythm, and the safety nets.
- [Version history](https://vlyai-1c28d863.mintlify.app/building/version-history.md): Every change in vly produces a revision. View, compare, roll back, or branch from any point in time.
- [Branching](https://vlyai-1c28d863.mintlify.app/building/branching.md): Create a branch to experiment without affecting the main project. Merge or discard. Sync with GitHub if connected.
- [Undo and redo](https://vlyai-1c28d863.mintlify.app/building/undo-redo.md): Reverse the last action, redo what you reversed. The keyboard-driven sibling of version history.
- [Sharing projects](https://vlyai-1c28d863.mintlify.app/building/sharing-projects.md): Public previews, password-protected links, embed codes, and how to share a project with someone outside your workspace.
- [Real-time collaboration](https://vlyai-1c28d863.mintlify.app/building/real-time-collaboration.md): Multiple people in the same project at the same time. Cursors, presence, and how conflicts are handled.
- [Comments and reviews](https://vlyai-1c28d863.mintlify.app/building/comments-and-reviews.md): Inline comments on code or pages. Review workflows for branches and prompts. Async feedback without interrupting.
- [Components panel](https://vlyai-1c28d863.mintlify.app/building/components-panel.md): Browse, search, and drag-and-drop the shadcn/ui component library. The visual interface to vly's design system.
- [Knowledge base](https://vlyai-1c28d863.mintlify.app/building/knowledge-base.md): Project-specific reference material the agent reads on every prompt. Drop in design system docs, brand voice, schema patterns, anything you'd otherwise repeat.
- [Custom instructions](https://vlyai-1c28d863.mintlify.app/building/custom-instructions.md): Always-on guidance the agent follows across every prompt. Coding style, brand voice, defaults — set once, applied everywhere.
- [Templates](https://vlyai-1c28d863.mintlify.app/building/templates.md): Pre-built starting points for new projects — SaaS, marketplace, dashboard, chat, blog. Fork and customize.
- [Cross-project referencing](https://vlyai-1c28d863.mintlify.app/building/cross-project-referencing.md): Pull a component, schema, or pattern from one of your projects into another. The way vly users build their own personal libraries.
- [Features overview](https://vlyai-1c28d863.mintlify.app/features/overview.md): An index of every feature in vly — agents, design system, data, auth, workspace, billing, and more.
- [Claude Code](https://vlyai-1c28d863.mintlify.app/features/agents/claude-code.md): Anthropic's Claude. The default agent in vly. Best for large refactors, deep multi-file reasoning, and tasks that require holding the whole project in working memory.
- [OpenAI Codex](https://vlyai-1c28d863.mintlify.app/features/agents/openai-codex.md): OpenAI's coding model. The fastest agent in vly for small, surgical changes — one-line fixes, single-function rewrites, tight refactors.
- [Gemini CLI](https://vlyai-1c28d863.mintlify.app/features/agents/gemini-cli.md): Google's Gemini coding agent. Best in vly for multi-file design work, layout passes, and schema modeling.
- [Choosing an agent](https://vlyai-1c28d863.mintlify.app/features/agents/choosing-an-agent.md): When to pick Claude Code, OpenAI Codex, or Gemini CLI for any given prompt. The full decision tree.
- [Agent preferences](https://vlyai-1c28d863.mintlify.app/features/agents/agent-preferences.md): Set per-workspace default agents and per-project overrides. Configure agent-specific behavior.
- [Fallback behavior](https://vlyai-1c28d863.mintlify.app/features/agents/fallback-behavior.md): What happens when your selected agent is unavailable — provider outages, rate limits, or maintenance.
- [Design systems](https://vlyai-1c28d863.mintlify.app/features/design/design-systems.md): The starting design system every vly project ships with — Tailwind tokens, shadcn/ui components, theme primitives — and how to extend it.
- [Themes](https://vlyai-1c28d863.mintlify.app/features/design/themes.md): Light, dark, and system themes. Brand color overrides. How vly handles theme tokens and how to extend them.
- [Tailwind config](https://vlyai-1c28d863.mintlify.app/features/design/tailwind-config.md): Edit the Tailwind config directly. Add custom colors, spacing, breakpoints, and plugins.
- [shadcn/ui components](https://vlyai-1c28d863.mintlify.app/features/design/shadcn-components.md): The component library every vly app ships with. Accessible, themeable, and owned by your project.
- [Typography](https://vlyai-1c28d863.mintlify.app/features/design/typography.md): Font families, weights, scale, and line-height. Inter by default; swap fonts with one prompt.
- [Icons and assets](https://vlyai-1c28d863.mintlify.app/features/design/icons-and-assets.md): Icon libraries, image uploads, SVG handling, and asset optimization.
- [Responsive previews](https://vlyai-1c28d863.mintlify.app/features/design/responsive-previews.md): Preview your app at mobile, tablet, and desktop breakpoints side by side. Catch responsive issues without resizing the browser.
- [Convex backend](https://vlyai-1c28d863.mintlify.app/features/data/convex-overview.md): Convex is the reactive backend that vly apps run on. Real-time queries, end-to-end TypeScript, queries / mutations / actions, file storage, vector search, and more.
- [Real-time sync](https://vlyai-1c28d863.mintlify.app/features/data/realtime-sync.md): How Convex's reactive queries auto-update on the client when data changes — no polling, no websocket plumbing.
- [File storage](https://vlyai-1c28d863.mintlify.app/features/data/file-storage.md): Upload, store, and serve files. Built-in image transformations. No S3 setup required.
- [Background jobs](https://vlyai-1c28d863.mintlify.app/features/data/background-jobs.md): Long-running work, retries, and durable workflows. The Convex action pattern for jobs that can't fit in a request.
- [Scheduled functions](https://vlyai-1c28d863.mintlify.app/features/data/scheduled-functions.md): Cron-style or delayed one-shot execution. Use for nightly cleanups, reminder emails, periodic data sync.
- [Built-in auth](https://vlyai-1c28d863.mintlify.app/features/auth/built-in-auth.md): Every vly app ships with authentication out of the box — email + password, magic links, social providers, roles, and permissions. Production-grade defaults, no third-party signup required.
- [Passwordless (magic links)](https://vlyai-1c28d863.mintlify.app/features/auth/passwordless.md): Sign in via email-only magic links. No passwords to forget, no resets, no leaks.
- [OAuth providers](https://vlyai-1c28d863.mintlify.app/features/auth/oauth-providers.md): Sign in with Google, GitHub, Microsoft, Discord, Apple, and more. Toggle on in workspace settings.
- [Roles and permissions](https://vlyai-1c28d863.mintlify.app/features/auth/roles-and-permissions.md): Role-based access control with resource-level scoping. Owner / admin / member by default; customizable per project.
- [Workspaces](https://vlyai-1c28d863.mintlify.app/features/workspace/workspaces.md): The top-level container for projects, members, and billing. A user can belong to many workspaces.
- [Workspace roles](https://vlyai-1c28d863.mintlify.app/features/workspace/roles.md): Owner, admin, member, and viewer — what each role can do at the workspace level.
- [Permissions](https://vlyai-1c28d863.mintlify.app/features/workspace/permissions.md): The full permission matrix — what each workspace role can do, by feature.
- [Audit logs](https://vlyai-1c28d863.mintlify.app/features/workspace/audit-logs.md): Every meaningful action in your workspace, logged, timestamped, and exportable.
- [SSO (Single Sign-On)](https://vlyai-1c28d863.mintlify.app/features/workspace/sso.md): SAML 2.0 and OIDC support for enterprise workspaces. SCIM provisioning. Domain-based auto-routing.
- [Plans](https://vlyai-1c28d863.mintlify.app/features/billing/plans.md): Free, Pro, Business, Enterprise — what's included in each, and how to pick the right tier.
- [Credits](https://vlyai-1c28d863.mintlify.app/features/billing/credits.md): How vly meters agent runs. Typical credit costs by change size, and how to manage usage.
- [Usage limits](https://vlyai-1c28d863.mintlify.app/features/billing/usage-limits.md): Per-plan caps on credits, projects, members, and concurrent branches. What happens at the cap.
- [Invoices](https://vlyai-1c28d863.mintlify.app/features/billing/invoices.md): Where to find your invoices, how to download, and how to add custom billing details.
- [Upgrade / downgrade](https://vlyai-1c28d863.mintlify.app/features/billing/upgrade-downgrade.md): How to change plans. Prorating, scheduled changes, what happens to your data.
- [Prompting](https://vlyai-1c28d863.mintlify.app/prompting/overview.md): The single biggest lever on vly output quality. This section is a complete guide to writing prompts that produce what you actually want — fast, with fewer iterations.
- [Prompting fundamentals](https://vlyai-1c28d863.mintlify.app/prompting/fundamentals.md): The mindset and structure of a good vly prompt. The three-line opening that handles most changes, plus the principles behind it.
- [Structuring prompts](https://vlyai-1c28d863.mintlify.app/prompting/structuring-prompts.md): When and how to structure longer prompts with headers, bullets, and examples.
- [The five-layer method](https://vlyai-1c28d863.mintlify.app/prompting/the-five-layer-method.md): A reusable framework for writing vly prompts. Five layers — Goal, User, Data, Behavior, Constraints — that take 20 minutes to learn and pay off across every project.
- [Debugging prompts](https://vlyai-1c28d863.mintlify.app/prompting/debugging-prompts.md): When the agent gets it wrong, here's how to diagnose why and re-prompt cleanly.
- [Iterating effectively](https://vlyai-1c28d863.mintlify.app/prompting/iterating-effectively.md): Patterns for momentum across long prompt sessions. Same content as Building → iterating, focused on the prompting craft.
- [Common prompting mistakes](https://vlyai-1c28d863.mintlify.app/prompting/common-mistakes.md): The ten most common ways prompts go wrong, with fixes.
- [CRUD apps](https://vlyai-1c28d863.mintlify.app/prompting/by-app-type/crud.md): Prompts for the bread-and-butter pattern — a list of things, with create / edit / delete.
- [Marketplace apps](https://vlyai-1c28d863.mintlify.app/prompting/by-app-type/marketplace.md): Prompts for two-sided marketplaces — buyers, sellers, listings, transactions.
- [Chat apps](https://vlyai-1c28d863.mintlify.app/prompting/by-app-type/chat.md): Prompts for real-time messaging — channels, threads, presence, attachments.
- [Dashboard apps](https://vlyai-1c28d863.mintlify.app/prompting/by-app-type/dashboard.md): Prompts for metrics dashboards — charts, filters, time ranges, real-time updates.
- [Multiplayer apps](https://vlyai-1c28d863.mintlify.app/prompting/by-app-type/multiplayer.md): Prompts for real-time multiplayer — lobbies, state sync, leaderboards.
- [E-commerce apps](https://vlyai-1c28d863.mintlify.app/prompting/by-app-type/e-commerce.md): Prompts for online stores — catalog, cart, checkout, inventory, orders.
- [Prompt library](https://vlyai-1c28d863.mintlify.app/prompting/prompt-library.md): 30+ tested prompt templates for common features and app shapes. Copy, adapt, ship.
- [Convex overview](https://vlyai-1c28d863.mintlify.app/convex/overview.md): The reactive backend that powers every vly app. Schema, queries, mutations, actions, scheduled functions, file storage, vector search, full-text search.
- [Schema](https://vlyai-1c28d863.mintlify.app/convex/schema.md): Define your tables, fields, types, indexes, and validators. The single source of truth for your app's data shape.
- [Queries](https://vlyai-1c28d863.mintlify.app/convex/queries.md): Convex queries — reactive read functions that auto-update on the client when underlying data changes.
- [Mutations](https://vlyai-1c28d863.mintlify.app/convex/mutations.md): Convex mutations — transactional write functions. Cannot call third-party APIs.
- [Actions](https://vlyai-1c28d863.mintlify.app/convex/actions.md): Convex actions — for side effects, third-party API calls, and anything that touches the outside world.
- [Scheduled functions](https://vlyai-1c28d863.mintlify.app/convex/scheduled-functions.md): Run a Convex function at a future time — once after a delay, or on a recurring cron schedule.
- [File storage](https://vlyai-1c28d863.mintlify.app/convex/file-storage.md): Upload files directly to Convex from the client. Get a storage ID; serve via Convex's CDN.
- [Vector search](https://vlyai-1c28d863.mintlify.app/convex/vector-search.md): Semantic search via embeddings, built into Convex. Pair with OpenAI / other embedding providers.
- [Full-text search](https://vlyai-1c28d863.mintlify.app/convex/full-text-search.md): BM25-style search across text fields. Built into Convex, no external service.
- [Auth integration](https://vlyai-1c28d863.mintlify.app/convex/auth-integration.md): How Convex's auth context works inside queries, mutations, and actions.
- [Indexes](https://vlyai-1c28d863.mintlify.app/convex/indexes.md): Make queries fast. Index design rules, when to add an index, and how to inspect query performance.
- [Migrations](https://vlyai-1c28d863.mintlify.app/convex/migrations.md): How vly handles schema evolution. Adding fields, renaming, removing, and backfilling existing data.
- [Architecture & patterns](https://vlyai-1c28d863.mintlify.app/architecture/overview.md): Reusable patterns for the architectural decisions every vly app eventually faces. Component shape, data modeling, auth, caching, scaling.
- [Component patterns](https://vlyai-1c28d863.mintlify.app/architecture/component-patterns.md): How to structure React components in a vly project — composition, reusability, prop drilling vs. context, when to extract.
- [Data modeling](https://vlyai-1c28d863.mintlify.app/architecture/data-modeling.md): Schema patterns for the most common app shapes — multi-tenant SaaS, hierarchies, soft deletes, audit trails, polymorphism.
- [Auth flows](https://vlyai-1c28d863.mintlify.app/architecture/auth-flows.md): Patterns for sign-up, sign-in, password reset, MFA, OAuth, magic links, and session management.
- [State management](https://vlyai-1c28d863.mintlify.app/architecture/state-management.md): Where to put state — Convex, URL, localStorage, React state, Zustand. The decision tree.
- [Caching](https://vlyai-1c28d863.mintlify.app/architecture/caching.md): What to cache, where, and how to invalidate. Convex-side caching is automatic; this page covers everything else.
- [Error handling](https://vlyai-1c28d863.mintlify.app/architecture/error-handling.md): Error boundaries, retry policies, user-facing error UX. Patterns for failing gracefully.
- [Optimistic updates](https://vlyai-1c28d863.mintlify.app/architecture/optimistic-updates.md): Show the result before the server confirms. Patterns for instant client feedback.
- [Pagination](https://vlyai-1c28d863.mintlify.app/architecture/pagination.md): Infinite scroll vs. paginated tables. Cursors vs. offsets. Convex pagination patterns.
- [Search patterns](https://vlyai-1c28d863.mintlify.app/architecture/search-patterns.md): Full-text search, vector search, filter UIs, and when to use which.
- [File uploads](https://vlyai-1c28d863.mintlify.app/architecture/file-uploads.md): Direct-to-storage uploads, validation, previews. The patterns that don't break under load.
- [Real-time sync patterns](https://vlyai-1c28d863.mintlify.app/architecture/realtime-sync-patterns.md): Patterns for sync, presence, collaborative editing, and other live-updating features.
- [Multi-tenancy](https://vlyai-1c28d863.mintlify.app/architecture/multi-tenancy.md): Patterns for apps where multiple customers share infrastructure. Workspaces, isolation, per-tenant limits.
- [Rate limiting](https://vlyai-1c28d863.mintlify.app/architecture/rate-limiting.md): Per-user, per-IP, per-endpoint patterns for rate limiting. Defending against abuse and runaway bills.
- [Deployment & hosting](https://vlyai-1c28d863.mintlify.app/deployment/overview.md): How vly apps deploy, what infrastructure they run on, environments, and the patterns for going from preview to production.
- [Environments](https://vlyai-1c28d863.mintlify.app/deployment/environments.md): Adding, configuring, and deleting environments. Default Preview / Production setup, plus custom environments for staging and per-team.
- [Environment variables](https://vlyai-1c28d863.mintlify.app/deployment/environment-variables.md): Setting, reading, and rotating environment variables. Per-environment scoping.
- [Secrets](https://vlyai-1c28d863.mintlify.app/deployment/secrets.md): How vly stores, encrypts, and serves secrets. Per-environment scoping, rotation, audit.
- [Custom domains](https://vlyai-1c28d863.mintlify.app/deployment/custom-domains.md): Point your own domain at a vly app. DNS records, SSL, apex domains, redirects, multi-environment setups — the complete walkthrough.
- [DNS setup](https://vlyai-1c28d863.mintlify.app/deployment/dns-setup.md): Provider-specific DNS guides for connecting custom domains to vly. Cloudflare, Namecheap, GoDaddy, Google.
- [SSL certificates](https://vlyai-1c28d863.mintlify.app/deployment/ssl-certificates.md): How vly provisions and renews SSL via Let's Encrypt. Custom certificates for enterprise customers.
- [Staging vs production](https://vlyai-1c28d863.mintlify.app/deployment/staging-vs-production.md): Patterns for safe promotion. When to add a staging environment, and how to gate it.
- [Rollback](https://vlyai-1c28d863.mintlify.app/deployment/rollback.md): Instant rollback for production deployments. The escape hatch when something breaks.
- [Preview deployments](https://vlyai-1c28d863.mintlify.app/deployment/preview-deployments.md): Per-change preview URLs for collaborative review. Multi-preview workflows for parallel work.
- [Monitoring](https://vlyai-1c28d863.mintlify.app/deployment/monitoring.md): Logs, metrics, alerting. What vly provides out of the box, plus integrations for deeper observability.
- [Troubleshooting](https://vlyai-1c28d863.mintlify.app/troubleshooting/overview.md): When something's not working, start here. Common errors, debugging workflows, when to contact support.
- [Common errors](https://vlyai-1c28d863.mintlify.app/troubleshooting/common-errors.md): The errors you're most likely to hit, with fixes.
- [Build failures](https://vlyai-1c28d863.mintlify.app/troubleshooting/build-failures.md): When the type-checker rejects the build. Diagnosis and fixes.
- [Deployment issues](https://vlyai-1c28d863.mintlify.app/troubleshooting/deployment-issues.md): DNS, SSL, custom domain, and promotion problems.
- [Integration problems](https://vlyai-1c28d863.mintlify.app/troubleshooting/integration-problems.md): Per-integration troubleshooting — Stripe webhooks, OAuth redirects, Resend deliverability.
- [Performance issues](https://vlyai-1c28d863.mintlify.app/troubleshooting/performance-issues.md): Slow queries, slow page loads, slow agent responses. Diagnosis and fixes.
- [Debugging workflow](https://vlyai-1c28d863.mintlify.app/troubleshooting/debugging-workflow.md): When you don't know where to start — the systematic approach.
- [Contacting support](https://vlyai-1c28d863.mintlify.app/troubleshooting/contacting-support.md): When and how to reach out. Channels per plan and what to include in your message.
- [Escalation](https://vlyai-1c28d863.mintlify.app/troubleshooting/escalation.md): For urgent production issues on Business and Enterprise tiers.
- [Security](https://vlyai-1c28d863.mintlify.app/security/overview.md): How vly secures your data, secrets, and accounts. Encryption, access control, isolation, audit logs, compliance — and what you can do on your side.
- [Auth best practices](https://vlyai-1c28d863.mintlify.app/security/auth-best-practices.md): Patterns for safe sign-up, password reset, MFA, and session management.
- [Secrets management](https://vlyai-1c28d863.mintlify.app/security/secrets-management.md): Where API keys live, how they're protected, and how to rotate them safely.
- [Input validation](https://vlyai-1c28d863.mintlify.app/security/input-validation.md): Catch bad data at the boundary. Convex schema validators, business-rule validation, sanitization.
- [Data access control](https://vlyai-1c28d863.mintlify.app/security/data-access-control.md): Per-user, per-workspace, per-team scoping patterns. Defending against data leaks.
- [XSS and CSRF](https://vlyai-1c28d863.mintlify.app/security/xss-csrf.md): How vly handles cross-site scripting and cross-site request forgery. What you should still watch for.
- [Rate limiting (security)](https://vlyai-1c28d863.mintlify.app/security/rate-limiting.md): Defending against abuse with rate limits. Per-user, per-IP, per-endpoint patterns.
- [Audit logs (security)](https://vlyai-1c28d863.mintlify.app/security/audit-logs.md): What gets logged, how to access, how to export. Compliance use cases.
- [Compliance](https://vlyai-1c28d863.mintlify.app/security/compliance.md): GDPR, SOC 2, HIPAA, ISO 27001 — current status and how vly customers use vly's controls to meet their own obligations.
- [Data export](https://vlyai-1c28d863.mintlify.app/security/data-export.md): Export your data — for portability, GDPR, or migration. Self-service for users and admins.
- [Account deletion](https://vlyai-1c28d863.mintlify.app/security/account-deletion.md): Permanent deletion. What's purged, what's retained, and the recovery window.
- [Migrating from Lovable](https://vlyai-1c28d863.mintlify.app/migration/from-lovable.md): Move a project from Lovable to vly. Schema porting, prompt-style differences, deployment migration.
- [Migrating from v0](https://vlyai-1c28d863.mintlify.app/migration/from-v0.md): Bring v0-generated frontend code into a vly project as a starting design system.
- [Migrating from Bolt](https://vlyai-1c28d863.mintlify.app/migration/from-bolt.md): Re-prompting strategies and component reuse when moving from Bolt.new to vly.
- [Migrating from Replit](https://vlyai-1c28d863.mintlify.app/migration/from-replit.md): What translates from Replit to vly, what doesn't, and how to bring your existing data.
- [Migrating from Cursor](https://vlyai-1c28d863.mintlify.app/migration/from-cursor.md): vly and Cursor solve different problems. Many users keep Cursor for local editing alongside vly for net-new apps.
- [Integrations overview](https://vlyai-1c28d863.mintlify.app/integrations/overview.md): vly ships with 50+ first-class integrations across payments, auth, email, AI, analytics, and more. Add any of them by name in a prompt — vly handles the wiring.
- [Integration directory](https://vlyai-1c28d863.mintlify.app/integrations/directory.md): Searchable catalog of every supported integration.
- [Stripe](https://vlyai-1c28d863.mintlify.app/integrations/stripe.md): Add Stripe payments to your vly app — one-time charges, subscriptions, marketplaces, billing portals. Test mode by default, production with one switch.
- [LemonSqueezy](https://vlyai-1c28d863.mintlify.app/integrations/lemonsqueezy.md): Merchant-of-record payments. Handles tax, VAT, and compliance globally — a turnkey alternative to Stripe + Stripe Tax.
- [Paddle](https://vlyai-1c28d863.mintlify.app/integrations/paddle.md): Merchant-of-record for SaaS. Handles tax, dunning, subscription management.
- [Plaid](https://vlyai-1c28d863.mintlify.app/integrations/plaid.md): Bank account connections — for ACH transfers, balance verification, account linking.
- [Polar](https://vlyai-1c28d863.mintlify.app/integrations/polar.md): Open-source SaaS billing. Subscriptions, one-time charges, customer portal — friendly to indie devs.
- [Clerk](https://vlyai-1c28d863.mintlify.app/integrations/clerk.md): Drop-in auth UI components, social providers, and a polished management dashboard. The premium auth alternative.
- [Auth0](https://vlyai-1c28d863.mintlify.app/integrations/auth0.md): Enterprise SSO, fine-grained access control, multi-tenant. The veteran in the auth space.
- [WorkOS](https://vlyai-1c28d863.mintlify.app/integrations/workos.md): SAML SSO + SCIM provisioning for B2B SaaS. Designed specifically for selling to enterprises.
- [Firebase Auth](https://vlyai-1c28d863.mintlify.app/integrations/firebase-auth.md): Google's auth platform. Mature, broad provider support, generous free tier.
- [Supabase Auth](https://vlyai-1c28d863.mintlify.app/integrations/supabase-auth.md): Open-source auth platform. Pairs naturally with Supabase as a database, but works standalone too.
- [Resend](https://vlyai-1c28d863.mintlify.app/integrations/resend.md): Send transactional and marketing emails from your vly app via Resend. Generous free tier, beautiful developer experience, deliverability built in.
- [SendGrid](https://vlyai-1c28d863.mintlify.app/integrations/sendgrid.md): Mature email infrastructure from Twilio. High deliverability, deep features, complex pricing.
- [Postmark](https://vlyai-1c28d863.mintlify.app/integrations/postmark.md): Best-in-class deliverability for transactional email. Strict sending policies, premium pricing.
- [Mailchimp](https://vlyai-1c28d863.mintlify.app/integrations/mailchimp.md): Marketing-focused email — campaigns, automation, segmentation.
- [Twilio](https://vlyai-1c28d863.mintlify.app/integrations/twilio.md): SMS, voice, programmable phone numbers. The standard for phone-based features.
- [WhatsApp Business](https://vlyai-1c28d863.mintlify.app/integrations/whatsapp.md): Send and receive WhatsApp messages programmatically via the Cloud API.
- [Telegram](https://vlyai-1c28d863.mintlify.app/integrations/telegram.md): Send messages and build bots via Telegram's Bot API. Free, popular for community features.
- [OpenAI](https://vlyai-1c28d863.mintlify.app/integrations/openai.md): Add OpenAI's models — GPT-4o, GPT-4o mini, embeddings, image generation, audio — to your vly app. The default LLM provider for AI features.
- [Anthropic (Claude)](https://vlyai-1c28d863.mintlify.app/integrations/anthropic.md): Anthropic's Claude models. Often the best pick for nuanced chat, long context, and careful reasoning.
- [Google AI (Gemini)](https://vlyai-1c28d863.mintlify.app/integrations/google-ai.md): Google's Gemini models. Strong on multimodal (vision, audio), long context, and code.
- [Replicate](https://vlyai-1c28d863.mintlify.app/integrations/replicate.md): Run open-source AI models — image generation, video, audio, fine-tuned models — via a simple API.
- [ElevenLabs](https://vlyai-1c28d863.mintlify.app/integrations/elevenlabs.md): Best-in-class text-to-speech and voice cloning. Natural-sounding voices in 30+ languages.
- [Pinecone](https://vlyai-1c28d863.mintlify.app/integrations/pinecone.md): Hosted vector database. Use when you outgrow Convex's built-in vector search or need specialty features.
- [Qdrant](https://vlyai-1c28d863.mintlify.app/integrations/qdrant.md): Open-source vector database. Self-hosted or hosted via Qdrant Cloud.
- [Hugging Face](https://vlyai-1c28d863.mintlify.app/integrations/huggingface.md): The open-source AI model hub. Inference API plus model hosting.
- [Supabase](https://vlyai-1c28d863.mintlify.app/integrations/supabase.md): Open-source Postgres + storage + realtime. Use as an alternative or supplement to Convex.
- [MongoDB](https://vlyai-1c28d863.mintlify.app/integrations/mongodb.md): Document database. Use when you need to connect to existing MongoDB data or specific MongoDB features.
- [Algolia](https://vlyai-1c28d863.mintlify.app/integrations/algolia.md): Hosted search-as-a-service. Best when you need typo-tolerance, faceting, and sub-50ms search across millions of records.
- [Meilisearch](https://vlyai-1c28d863.mintlify.app/integrations/meilisearch.md): Open-source search engine. Self-hostable; alternative to Algolia.
- [BigQuery](https://vlyai-1c28d863.mintlify.app/integrations/bigquery.md): Google Cloud's analytics warehouse. For complex analytics queries on large datasets.
- [Snowflake](https://vlyai-1c28d863.mintlify.app/integrations/snowflake.md): Enterprise data warehouse. Use for complex analytics across very large datasets.
- [Cloudinary](https://vlyai-1c28d863.mintlify.app/integrations/cloudinary.md): Image and video CDN with on-the-fly transformations. The standard for media-heavy apps.
- [Mux](https://vlyai-1c28d863.mintlify.app/integrations/mux.md): Video infrastructure — upload, transcode, stream with adaptive bitrate. The standard for video-heavy apps.
- [AWS S3](https://vlyai-1c28d863.mintlify.app/integrations/aws-s3.md): Object storage. Use when Convex's 100 MB file limit isn't enough or you need region-specific storage.
- [Cloudflare R2](https://vlyai-1c28d863.mintlify.app/integrations/cloudflare-r2.md): S3-compatible object storage with no egress fees. Cheaper than S3 for high-bandwidth use cases.
- [UploadThing](https://vlyai-1c28d863.mintlify.app/integrations/uploadthing.md): File uploads as a service. Drop-in upload UI components plus storage.
- [LiveKit](https://vlyai-1c28d863.mintlify.app/integrations/livekit.md): Open-source WebRTC for real-time video, voice, and data. Self-hostable or hosted.
- [Daily](https://vlyai-1c28d863.mintlify.app/integrations/daily.md): Hosted video calling. Polished SDKs, fast time-to-integration.
- [Agora](https://vlyai-1c28d863.mintlify.app/integrations/agora.md): Real-time engagement APIs. Enterprise-grade video, voice, and chat.
- [PostHog](https://vlyai-1c28d863.mintlify.app/integrations/posthog.md): Open-source product analytics with session replay, feature flags, and experimentation.
- [Mixpanel](https://vlyai-1c28d863.mintlify.app/integrations/mixpanel.md): Event-based product analytics. Strong funnel and cohort analysis.
- [Amplitude](https://vlyai-1c28d863.mintlify.app/integrations/amplitude.md): Product analytics with strong cohort and behavioral analysis.
- [Sentry](https://vlyai-1c28d863.mintlify.app/integrations/sentry.md): Error tracking + performance monitoring with rich context. The standard for production apps.
- [Datadog](https://vlyai-1c28d863.mintlify.app/integrations/datadog.md): Enterprise APM, logs, metrics, alerting in one platform.
- [LogSnag](https://vlyai-1c28d863.mintlify.app/integrations/logsnag.md): Lightweight event tracking and notifications. Like Slack alerts for your app's important events.
- [GitHub](https://vlyai-1c28d863.mintlify.app/integrations/github.md): Sync your vly project to a GitHub repository. Commit, branch, open PRs, run Actions — all from inside vly.
- [GitLab](https://vlyai-1c28d863.mintlify.app/integrations/gitlab.md): Sync your vly project to GitLab. Same pattern as GitHub integration.
- [Vercel](https://vlyai-1c28d863.mintlify.app/integrations/vercel.md): Deploy your vly-generated app to Vercel as well as vly's managed hosting.
- [Netlify](https://vlyai-1c28d863.mintlify.app/integrations/netlify.md): Deploy your vly-generated app to Netlify as well as vly's managed hosting.
- [Linear](https://vlyai-1c28d863.mintlify.app/integrations/linear.md): Issue tracking. Create issues from your app, sync project status, surface Linear data in dashboards.
- [Asana](https://vlyai-1c28d863.mintlify.app/integrations/asana.md): Project management. Sync tasks, projects, and statuses between Asana and your app.
- [Notion](https://vlyai-1c28d863.mintlify.app/integrations/notion.md): Sync content with Notion databases. Use as a CMS for marketing pages or as a customer-facing knowledge base.
- [Slack](https://vlyai-1c28d863.mintlify.app/integrations/slack.md): Send messages to Slack channels and DMs. Build slash commands, interactive workflows.
- [Discord](https://vlyai-1c28d863.mintlify.app/integrations/discord.md): Send messages to Discord servers. Build bots that listen for commands and react.
- [HubSpot](https://vlyai-1c28d863.mintlify.app/integrations/hubspot.md): Marketing & sales CRM. Sync leads, contacts, deals between your app and HubSpot.
- [Cookbook](https://vlyai-1c28d863.mintlify.app/recipes/overview.md): Step-by-step builds for the most-asked apps. Production patterns, copy-paste code, complete prompts. The fastest way to learn vly is to ship something real.
- [How recipes work](https://vlyai-1c28d863.mintlify.app/recipes/how-recipes-work.md): The structure of every recipe — what to expect, time estimates, prerequisites.
- [Multi-tenant SaaS](https://vlyai-1c28d863.mintlify.app/recipes/multi-tenant-saas.md): The foundation pattern for every B2B app. Workspaces, teams, members, roles, and per-tenant data isolation. Take this and add your domain logic on top.
- [Marketplace with Stripe](https://vlyai-1c28d863.mintlify.app/recipes/marketplace-with-stripe.md): A two-sided marketplace — buyers, sellers, listings, and money flowing through Stripe Connect. The complete walkthrough.
- [Real-time chat app](https://vlyai-1c28d863.mintlify.app/recipes/realtime-chat-app.md): Build a Slack-style chat app — channels, messages, presence, attachments. ~60 minutes.
- [Newsletter platform](https://vlyai-1c28d863.mintlify.app/recipes/newsletter-platform.md): Build a newsletter app — subscribers, posts, archives, paid tiers. ~45 minutes.
- [Internal CRM](https://vlyai-1c28d863.mintlify.app/recipes/internal-crm.md): Pipeline, contacts, tasks, and email integration. The CRM your team won't hate. ~60 minutes.
- [Dashboard with charts](https://vlyai-1c28d863.mintlify.app/recipes/dashboard-with-charts.md): Metrics, filters, time ranges, real-time updates. ~30 minutes.
- [Multiplayer game](https://vlyai-1c28d863.mintlify.app/recipes/multiplayer-game.md): Lobbies, real-time state sync, leaderboards. ~75 minutes.
- [AI chatbot](https://vlyai-1c28d863.mintlify.app/recipes/ai-chatbot.md): Build a streaming AI chatbot — conversation history, tool calling, multi-model selection — using OpenAI or Anthropic. The recipe everyone asks for.
- [Image generator](https://vlyai-1c28d863.mintlify.app/recipes/image-generator.md): User prompts → DALL-E or Replicate → stored gallery. ~30 minutes.
- [Voice AI app](https://vlyai-1c28d863.mintlify.app/recipes/voice-ai-app.md): STT (Whisper) + LLM + TTS (ElevenLabs). Push-to-talk in, AI voice out. ~60 minutes.
- [Booking system](https://vlyai-1c28d863.mintlify.app/recipes/booking-system.md): Calendar availability, slot booking, confirmations. Calendly-style. ~75 minutes.
- [Job board](https://vlyai-1c28d863.mintlify.app/recipes/job-board.md): Listings, applications, employer + applicant accounts. ~60 minutes.
- [Invoice generator](https://vlyai-1c28d863.mintlify.app/recipes/invoice-generator.md): Create, send, track invoices. PDF generation. ~30 minutes.
- [Expense tracker](https://vlyai-1c28d863.mintlify.app/recipes/expense-tracker.md): Categories, receipts, monthly summaries. ~30 minutes.
- [Course platform](https://vlyai-1c28d863.mintlify.app/recipes/course-platform.md): Lessons, video hosting, progress tracking, certificates. ~90 minutes.
- [Subscription billing](https://vlyai-1c28d863.mintlify.app/recipes/subscription-billing.md): Multi-tier subscriptions, trials, billing portal, dunning. ~60 minutes.
- [Social network](https://vlyai-1c28d863.mintlify.app/recipes/social-network.md): Profiles, follows, feed, reactions. ~75 minutes.
- [Forum](https://vlyai-1c28d863.mintlify.app/recipes/forum.md): Categories, threads, posts, voting, moderation. ~60 minutes.
- [Wiki](https://vlyai-1c28d863.mintlify.app/recipes/wiki.md): Pages, edits, history, references. ~45 minutes.
- [Notes app](https://vlyai-1c28d863.mintlify.app/recipes/notes-app.md): Rich-text notes, tags, search. ~30 minutes.
- [Habit tracker](https://vlyai-1c28d863.mintlify.app/recipes/habit-tracker.md): Daily check-ins, streaks, charts. ~30 minutes.
- [OAuth login](https://vlyai-1c28d863.mintlify.app/recipes/oauth-login.md): Add Google, GitHub, or other OAuth providers as a sign-in option.
- [File uploads](https://vlyai-1c28d863.mintlify.app/recipes/file-uploads.md): Direct-to-Convex uploads with previews and limits. The standard pattern.
- [Email campaigns](https://vlyai-1c28d863.mintlify.app/recipes/email-campaigns.md): Send to a list of users, track delivery, handle unsubscribes.
- [Webhooks](https://vlyai-1c28d863.mintlify.app/recipes/webhooks.md): Receive events from third-party services securely. The general pattern.
- [API reference](https://vlyai-1c28d863.mintlify.app/api-reference/introduction.md): Welcome to the vly.ai REST API. Authentication, base URLs, common patterns, SDKs, and the full endpoint catalog.
- [Authentication](https://vlyai-1c28d863.mintlify.app/api-reference/authentication.md): How to authenticate to the vly.ai REST API. API keys, OAuth, scopes, key rotation, and security best practices.
- [Rate limits](https://vlyai-1c28d863.mintlify.app/api-reference/rate-limits.md): Per-key rate limits, headers, and how to handle 429 responses.
- [Errors](https://vlyai-1c28d863.mintlify.app/api-reference/errors.md): Standard error response shape and complete error code reference.
- [Pagination](https://vlyai-1c28d863.mintlify.app/api-reference/pagination.md): How list endpoints paginate. Cursors, page sizes, iterating to the end.
- [List projects](https://vlyai-1c28d863.mintlify.app/api-reference/projects/list.md): Returns a paginated list of projects in the authenticated workspace.
- [Create project](https://vlyai-1c28d863.mintlify.app/api-reference/projects/create.md): Creates a new vly project from a prompt. Returns the new Project record.
- [Get project](https://vlyai-1c28d863.mintlify.app/api-reference/projects/get.md): Returns a single project by ID.
- [Update project](https://vlyai-1c28d863.mintlify.app/api-reference/projects/update.md): Update a project's name or visibility. Returns the updated Project record.
- [Create deployment](https://vlyai-1c28d863.mintlify.app/api-reference/deployments/create.md): Trigger a new deployment for a project. Async — returns a Deployment record with status 'queued'.
- [Get deployment](https://vlyai-1c28d863.mintlify.app/api-reference/deployments/get.md): Returns the full Deployment record including current status and the live URL.
- [Trigger agent run](https://vlyai-1c28d863.mintlify.app/api-reference/agents/trigger.md): Asks an AI coding agent to work on a project. Returns an AgentRun record with a streaming URL.
- [Upload file](https://vlyai-1c28d863.mintlify.app/api-reference/files/upload.md): Upload a file to a project's Convex storage. Returns the file ID and a serving URL.
- [Get usage](https://vlyai-1c28d863.mintlify.app/api-reference/billing/usage.md): Returns the current billing period's usage broken down by category.
- [Send a test webhook](https://vlyai-1c28d863.mintlify.app/api-reference/webhooks/test.md): Send a sample event to a configured webhook endpoint. Useful for verifying signature handling.
- [TypeScript SDK](https://vlyai-1c28d863.mintlify.app/api-reference/sdks/typescript.md): @vly/sdk — full type safety, streaming support, automatic retries, and OpenAPI-generated types.
- [Python SDK](https://vlyai-1c28d863.mintlify.app/api-reference/sdks/python.md): vly Python SDK — sync + async clients, full type hints, automatic retries.
- [CLI](https://vlyai-1c28d863.mintlify.app/api-reference/sdks/cli.md): @vly/cli — terminal access to the same API. Useful for scripts, CI, and quick automation.
- [Webhooks SDK helpers](https://vlyai-1c28d863.mintlify.app/api-reference/sdks/webhooks.md): Signature verification helpers for handling vly webhooks securely in every supported language.
- [Changelog](https://vlyai-1c28d863.mintlify.app/resources/changelog.md): Notable releases, features, and fixes.
- [Roadmap](https://vlyai-1c28d863.mintlify.app/resources/roadmap.md): What we're building next. Major in-flight items, ordered by stage.
- [Status](https://vlyai-1c28d863.mintlify.app/resources/status.md): Live status of vly's services and AI agents.
- [Contact](https://vlyai-1c28d863.mintlify.app/resources/contact.md): Every way to reach us — support, sales, security, press.

## OpenAPI Specs

- [vly-api](https://vlyai-1c28d863.mintlify.app/openapi/vly-api.json)
- [openapi](https://vlyai-1c28d863.mintlify.app/api-reference/openapi.json)


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