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).
• Admin access to that repository.
• 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. These are repositories Itera should know about but won't prototype against, like backends, shared component libraries, or design system packages. Add as many as you want.
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.