Set up your first project

A project in Itera represents one product. Most companies start with their main web app.

What you need

• A repository for the frontend you want to iterate on (JavaScript or TypeScript).
• A backend or other reference repository to connect when your product has separate backend or shared-service code Itera should use for context.
• Admin access to the repository or repositories you connect.
• An account on Itera (you create one with your work email).

Steps

1. Create the project. Click the + button next to Projects in the left navigation, or go to Settings > Projects > New project.
2. Name the project. Use the same name your team uses internally.
3. Select a Git provider. Choose GitHub, self-hosted GitLab, or Bitbucket Cloud. Authenticate with OAuth.
4. Pick the frontend repository. This is the repo Itera will use to prototype changes. Without it, you can still use the workspace, but you lose the prototype features.
5. Add reference repositories if your product has them. Connect your backend repo and any other reference repositories, such as shared component libraries or design system packages, when you want Itera to use them for context. Itera uses these repositories for context but does not prototype against them.
6. Have your engineering team add the itera.yml file to the frontend repo. Itera walks you through this if it isn't there yet. The full reference lives at docs.iteradev.ai/platform/itera-yml.

Once setup is complete, the project shows up in your left navigation and is ready to use.