Skip to main content

Projects

Import a repository

Understand an existing GitHub codebase and build on its conventions.

Import connects a GitHub repository to a hosted pre.dev project. For code already on your machine, you can also use the CLI directly.

Choose the repository

Select Import, then choose an accessible repository or supply its URL. Connect the GitHub account that can access private repositories. Organization access depends on the permissions granted in GitHub.

Map the codebase

Let pre.dev analyze the code, dependencies, and structure. Use /reverse to refresh the architecture after significant changes. The output depends on the code and configuration available to the agent.

Configure the runtime

Review the installation and start commands, and fill required environment variables in Project setup → API Keys. An imported repository may need project-specific services or setup before its preview runs.

Request a focused change

Describe the desired behavior and the conventions to preserve.

Add a wishlist to the existing shop. Reuse the current auth,
database access layer, and component library. Include an empty
state and verify that one user cannot read another user's list.

Review the changes

Inspect the diff and reported checks, test the preview if available, and use the project’s Git workflow to merge and deploy.

For multiple connected GitHub accounts, check the account selected in Project setup → Connections. A project can pin one account or inherit its workspace default. See GitHub integration.

Was this page helpful?