Get started with an existing project

Firebase Studio offers a streamlined way to import existing web app projects into a Firebase Studio workspace, letting you continue to work on your existing projects with Firebase Studio's AI-powered assistance and streamlined development, deployment, and monitoring capabilities.

You can import projects from a source repository (GitHub, GitLab, or Bitbucket) or from a local archive file. Firebase Studio supports importing gzipped tar files and zip files under 50 MiB.

Get started

Step 1: Import your project

  1. Log into your Google Account and open Firebase Studio.

  2. Click Import a project. The Import project dialog appears.

  3. In the Repo URL field, enter your GitHub, GitLab, or Bitbucket repository URL.

  4. Enter a name for your project.

  5. If you're importing a Flutter project, enable This is a Flutter app. If not, leave the checkbox unchecked.

  6. Click Import.

  7. If the repository is private, you'll be prompted to authenticate to the respective provider:

    • For GitHub, follow the prompts to copy an access token.
    • For GitLab, you can use your account password or create a personal account token
    • For Bitbucket, use your username (not email) and an app password to authenticate.

Step 2: Install dependencies

By default, Firebase Studio doesn't install dependencies when you import a project, so you'll need to do this manually after your first import.

For example, if you import a Flutter app, you should run flutter pub get in the terminal, or npm install for Javascript or TypeScript apps.

You can change this for all future users of your template and for future imports by adding an onCreate hook to your dev.nix file in your project repository. You can configure onCreate to run the build command appropriate for your project (for example, npm install or flutter pub get).

After this is configured, dependencies are installed automatically whenever users import your repository into Firebase Studio.

Next steps