# Integrations





Ideavo connects your project to the services most apps need: a database, sign-in, payments and secrets. For a database or sign-in, you click once, answer a few questions, and the agent does the setup.

<Cards>
  <Card title="Database" icon="<Database />" description="A PostgreSQL database with Drizzle ORM. Ideavo can create one on Neon, or you can use your own." href="#database" />

  <Card title="Auth" icon="<ShieldCheck />" description="Sign-up, sign-in and account pages with Better Auth, plus a dashboard of your users." href="#authentication" />

  <Card title="Secrets" icon="<KeyRound />" description="Store API keys, tokens, and credentials securely. Project-scoped and never exposed in the chat or codebase." href="#secrets" />
</Cards>

## Where to Find Them [#where-to-find-them]

Database and Auth are tabs in your project. Click the **+** button on the tab strip and pick one.

<DocImage src="features/integrations/add-view-menu" alt="The add view menu open over a project, listing Preview, Code, Database, Auth, Secrets, Logs and Workflow" width="600" height="664" />

<Callout type="info">
  These tabs need the Editor role or higher, and they aren't available inside
  tasks. Set them up from your main project.
</Callout>

## Database [#database]

Give your app a real database, so its data is saved and shared instead of living in memory.

<DocVideo src="features/integrations/database-setup" alt="Clicking Add Database, answering the agent's questions, and seeing the tables in Drizzle Studio" width="1280" height="800" maxWidth="1024" />

<Steps>
  <Step>
    Open the **Database** tab and click **Add Database**, or ask for a database in chat.
  </Step>

  <Step>
    The agent reads your project and asks a few questions: where the database should come from, which tables you need, and whether to keep your sample data.
  </Step>

  <Step>
    It creates the database, installs Drizzle ORM, adds your tables, runs the migrations, and connects your app.
  </Step>

  <Step>
    When it finishes, the **Database** tab opens Drizzle Studio, where you can browse and edit your data.
  </Step>
</Steps>

<DocImage src="features/integrations/database-studio" alt="The Database tab showing a table of cards in Drizzle Studio" width="1630" height="1120" light="false" />

### Use Your Own Database [#use-your-own-database]

When the agent asks where the database should come from, choose your own PostgreSQL URL. If your project already uses another database or ORM, the agent asks whether to keep it or switch.

<Callout type="info">
  The **Database** tab opens Drizzle Studio, so it needs a project that uses
  Drizzle. With another ORM, manage your data with that tool instead.
</Callout>

### Claim Your Database [#claim-your-database]

When Ideavo creates your Neon database, it's provisioned on your behalf. Claiming it moves it to your own Neon account, so you control backups, scaling and access.

<Steps>
  <Step>
    Click **Claim** on the banner above the chat, or open **Settings → Database**.
  </Step>

  <Step>
    Click **Claim database**.
  </Step>

  <Step>
    Accept the transfer in Neon and choose the organization that receives it.
  </Step>
</Steps>

<Callout type="warn">
  Only the project owner can claim a database. Each project gets one free
  database, and it won't be replaced after you claim it.
</Callout>

## Authentication [#authentication]

Let people sign up and sign in, and keep each person's data their own.

<DocVideo src="features/integrations/auth-setup" alt="Clicking Add Auth, answering the agent's questions, and seeing users in the Auth dashboard" width="1280" height="800" maxWidth="1024" />

<Steps>
  <Step>
    Open the **Auth** tab and click **Add Auth**, or ask for sign-in in chat.
  </Step>

  <Step>
    The agent reads your project and sets up a database first if you don't have one.
  </Step>

  <Step>
    It asks a few questions, such as how the sign-in page should look, which pages need sign-in, and whether data should belong to each user.
  </Step>

  <Step>
    It adds Better Auth, creates the auth tables, builds the sign-in, sign-up and account pages, and protects the pages you chose.
  </Step>
</Steps>

### Auth Dashboard [#auth-dashboard]

The **Auth** tab shows total users, new signups and daily active users over time, along with a searchable list of your users, how they log in, and when they last signed in. It starts empty and fills up as people sign up.

<DocImage src="features/integrations/auth-dashboard" alt="The Auth dashboard with a chart of users and a table of signed-up users" width="1630" height="1680" />

### Use Another Provider [#use-another-provider]

Prefer Auth0, Clerk, NextAuth or something else? Tell the agent in chat and it will set that up instead. Add the credentials to your **Secrets** tab when asked.

<Callout type="info">
  The Auth dashboard only works with Ideavo's built-in Better Auth setup.
</Callout>

## Payments [#payments]

Connect your own Razorpay account in **Settings → Integrations**, and the agent adds checkout, subscriptions and paywalls to your apps. See [Razorpay](/docs/features/razorpay).

## Secrets [#secrets]

The Secrets tab is where all sensitive values live — API keys, connection strings, tokens, and any credentials your integrations or third-party services need.

* Secrets are **project-scoped** — not shared across projects
* They are injected into your environment at runtime and never hardcoded into your codebase
* You can add, update, or remove secrets at any time from the Secrets tab

<Callout type="warn">
  Never paste API keys or secrets directly into the chat. The chat is not a
  secure input for sensitive values. Always use the **Secrets tab**.
</Callout>

### FAQ [#faq]

<Accordions>
  <Accordion title="Can I use a different database than Neon?">
    Yes. Choose your own PostgreSQL URL when the agent asks, or tell the agent
    what you'd like to use in chat.
  </Accordion>

  <Accordion title="Can I use a different auth provider than Better Auth?">
    Yes. Better Auth is the built-in option. For other providers, such as Auth0,
    Clerk or NextAuth, ask the agent in chat and it will guide you through setup
    using your own credentials.
  </Accordion>

  <Accordion title="Can I move my database to my own Neon account?">
    Yes, if Ideavo created it for you. See [Claim Your
    Database](#claim-your-database).
  </Accordion>

  <Accordion title="What if the database migration fails?">
    The agent will surface the error in chat and attempt to resolve it. If it
    can't be fixed automatically, it will explain what went wrong and what you
    need to do next. You can also re-run migrations manually from the terminal
    in the IDE.
  </Accordion>

  <Accordion title="Are secrets shared across projects?">
    No. Secrets are project-scoped. Each project has its own isolated Secrets
    tab, and values are not accessible from other projects in your account.
  </Accordion>

  <Accordion title="Can I add any third-party service via chat?">
    Yes. Beyond the native Database, Auth and [Razorpay](/docs/features/razorpay)
    integrations, you can ask the agent to connect any service — Stripe, Resend,
    Cloudinary, S3, and more. The agent
    installs the required SDK, configures usage in your code, and tells you
    which secrets to add.
  </Accordion>
</Accordions>
