How to Create a New Project in CircleCI
Overview
For full instructions on creating and setting up a new project in CircleCI, see the official documentation:
Create a Project in CircleCI — step-by-step setup guide covering GitHub, GitLab, and Bitbucket
Common issues when setting up a project
If you're running into trouble during project setup, the following articles may help:
Repository not appearing in CircleCI
Verify that CircleCI has been granted access to your organization in your VCS provider's OAuth or GitHub App settings.
GitHub App vs. GitHub OAuth — different setup flows
CircleCI has two GitHub integration types with different project setup experiences. If your UI looks different from the documentation, check which integration your organization is using.
GitLab project setup
GitLab projects are set up through a standalone flow. See: GitLab integration overview
Config file not found after setup
If your first build fails with a missing config error, ensure a
.circleci/config.ymlfile exists in the root of your repository on the branch you're building.