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.
• See: Why can't I find my repo in CircleCI?

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.
• See: GitHub App integration overview

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.yml file exists in the root of your repository on the branch you're building.
• See: Getting started with CircleCI config

Additional Resources

• CircleCI Configuration Reference