> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Account setup

> Sign up, verify your email, customize your profile, and configure workspace defaults.

Setting up your vly account takes about two minutes. This page is a checklist of the things worth doing on day one.

## Create your account

<Steps>
  <Step title="Go to vly.ai/signup">
    Email + password, or one-click sign-in with Google or GitHub.
  </Step>

  <Step title="Verify your email">
    Click the link in the verification email. Until verified, you can use vly but some workspace operations are blocked.
  </Step>

  <Step title="Pick a username">
    This becomes your default workspace slug — `app.vly.ai/yourname`. Change later from settings.
  </Step>
</Steps>

## First-time defaults to set

<CardGroup cols={2}>
  <Card title="Default agent" icon="bot">
    **Settings → Preferences → Default agent**. Most users start with **Claude Code**. Switch later per project.
  </Card>

  <Card title="Default mode" icon="workflow">
    **Settings → Preferences → Default mode**. Plan mode for safety, Agent mode for speed. Toggle per prompt either way.
  </Card>

  <Card title="Theme" icon="palette">
    Light, dark, or system. The vly editor and dashboard respect your choice.
  </Card>

  <Card title="Notification preferences" icon="bell">
    Email digests for build failures, billing alerts, security events.
  </Card>
</CardGroup>

## Connect your accounts

Optional but recommended for most workflows:

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="/integrations/github">
    Sync projects to a GitHub repo. Open PRs from vly. Run GitHub Actions on push.
  </Card>

  <Card title="Google" icon="chrome">
    Sign in to vly with Google. Also enables Gmail / Calendar integrations down the line.
  </Card>

  <Card title="Slack" icon="slack" href="/integrations/slack">
    Build deploys, errors, billing alerts to your team's channels.
  </Card>

  <Card title="Stripe" icon="credit-card" href="/integrations/stripe">
    For projects that handle payments. Connect once; available across all your projects.
  </Card>
</CardGroup>

## Invite teammates

If you're working with a team, set up your workspace properly:

<Steps>
  <Step title="Create a workspace">
    Settings → Workspaces → Create. Pick a name and slug.
  </Step>

  <Step title="Invite members">
    Settings → Members → Invite. Pass them an invite link or send by email.
  </Step>

  <Step title="Assign roles">
    Owner / admin / member. Owners control billing; admins manage projects; members build.
  </Step>
</Steps>

See [Workspaces](/features/workspace/workspaces) and [Roles & permissions](/features/auth/roles-and-permissions) for the model.

## API access (optional)

If you'll integrate vly into your own tooling:

<Steps>
  <Step title="Generate an API key">
    Workspace settings → API keys → Create new key.
  </Step>

  <Step title="Store it securely">
    Use a secrets manager or a `.env` file. Never commit to source.
  </Step>

  <Step title="Test it">
    See the [API quickstart](/api-reference/introduction#quick-start).
  </Step>
</Steps>

## Verify everything works

Last sanity check: run through the [Quickstart](/getting-started/quickstart) and ship a hello-world app. \~5 minutes; confirms account, workspace, and deploy pipeline are healthy.

## Related

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Build and deploy your first app.
  </Card>

  <Card title="Workspaces" icon="building" href="/features/workspace/workspaces">
    Workspaces, teams, members.
  </Card>

  <Card title="Plans & pricing" icon="package" href="/getting-started/plans-and-pricing">
    Pick the right tier.
  </Card>
</CardGroup>


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