> ## Documentation Index
> Fetch the complete documentation index at: https://docs.specode.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating to Specode

> How to migrate your existing healthcare app from Lovable, Bolt, or other non-HIPAA-compliant platforms to Specode.

## Why migrate?

If you built a healthcare app on a platform like Lovable, Bolt, or another AI code generator, there's a good chance it isn't HIPAA-compliant. That means you can't safely handle protected health information (PHI) - patient records, appointment details, billing data, or anything that ties health info to a real person.

Specode is built for healthcare from the ground up. Every component, every integration, and the entire hosting stack is designed to meet HIPAA requirements. Migrating to Specode means your app gets compliant infrastructure without starting over from scratch.

## How migration works

We read your existing codebase, build a map of how your project works - the pages, the data models, the authentication, where information is stored - and use that to plan how it moves onto Specode. You keep the features and logic you've already built while gaining HIPAA-compliant infrastructure.

<Steps>
  <Step title="Give us read access to your code">
    Install our GitHub App so we can scan your repository. This is read-only - we can't change, delete, or push any code.
  </Step>

  <Step title="We scan and plan">
    Our system reads the code and builds a project map. We identify what can transfer directly, what needs adjustment for compliance, and flag anything that won't work in a HIPAA environment.
  </Step>

  <Step title="Review the migration plan">
    We walk you through what we found and how we'll rebuild it on Specode. You'll know exactly what's changing and why before any work begins.
  </Step>

  <Step title="Build on Specode">
    Your app gets rebuilt on Specode's HIPAA-compliant stack using our pre-built healthcare components. You can continue iterating with our AI coder just like you would on any other platform - but now with compliant infrastructure underneath.
  </Step>
</Steps>

## Install the Specode GitHub App

To get started, you'll need to give us read access to your repository. This takes about a minute.

<Card title="Install the GitHub App" icon="github" href="https://github.com/apps/specode-hipaa-scanning/installations/new">
  Open GitHub and install the Specode HIPAA scanning app on your repository.
</Card>

### Step-by-step

1. **Click the link above.** It opens a GitHub page for **Specode HIPAA scanning** - that's the name of our scanning app.
2. **Choose where to install.** GitHub asks which account to install on. Pick the personal account or organization that owns the repository.
3. **Select "Only select repositories."** Then pick just the repositories you want us to scan. We recommend this over "All repositories" - there's no reason to give us more access than needed.
4. **Click Install.** That's it. Nothing is downloaded and nothing on your side changes. Let us know it's done so we can start the scan.

<Note>
  You'll need to be signed in to GitHub. If the repository belongs to a company or team account, you may need to be an owner or admin.
</Note>

### What we can and can't do

The app is **read-only**. Here are the exact permissions GitHub grants it:

<CardGroup cols={2}>
  <Card title="We can" icon="check" color="#17693F">
    * Read the code in the repositories you selected
    * See basic repository details like name and branches
  </Card>

  <Card title="We can't" icon="xmark" color="#8A3B2A">
    * Change, delete, or push any code
    * Open pull requests or issues
    * See any repository you didn't select
    * See your password or personal account settings
  </Card>
</CardGroup>

<Info>
  **About the app name.** The app is called "Specode HIPAA scanning" because it was originally built for our healthcare compliance scanning. It's the same app we use to read a project during a migration - the name just hasn't caught up with everything it does.
</Info>

## Removing access

You can remove access at any time without asking us:

1. On GitHub, go to **Settings > Applications > Installed GitHub Apps**
2. Find **Specode HIPAA scanning** and click **Configure**
3. Change which repositories we can see, or uninstall the app entirely

For an organization, look under the organization's settings instead of your personal ones.

## What platforms can I migrate from?

We can migrate from any platform where your code is in a GitHub repository (or can be exported to one). Common platforms we've migrated from include:

* **Lovable** - AI app builder, not HIPAA-compliant
* **Bolt** - AI code generator, not HIPAA-compliant
* **v0 / Vercel** - Frontend tools without healthcare compliance
* **Custom React/Next.js projects** - On non-compliant hosting

If your code isn't on GitHub yet, push it to a repository first (even a private one), then follow the steps above.

## Questions?

Something not working, or the GitHub page asks for permissions that don't match what's described here? Don't continue - send us a screenshot at [support@specode.ai](mailto:support@specode.ai) and we'll check it out.