Tutorial: Starting with an empty project and manually adding resources - Amazon CodeCatalyst

Tutorial: Starting with an empty project and manually adding resources

You can create an empty project without any predefined resources inside it by choosing the Empty project blueprint when you create the project. After you create an empty project, you can create and add resources to it according to your project needs. Because projects created without a blueprint are empty on creation, this option requires more knowledge of creating and configuring CodeCatalyst resources to get started.


To create an empty project, you must have the Space administrator role assigned to you. If this is your first time signing in to CodeCatalyst, see Setting up CodeCatalyst.

Create an empty project

Creating a project is the first step in being able to work together. If you want to create your own resources, such as source repositories and workflows, you can start with an empty project.

To create an empty project
  1. Navigate to the space where you want to create a project.

  2. On the space dashboard, choose Create project.

  3. Choose Start from scratch.

  4. Under Give a name to your project, enter the name that you want to assign to your project. The name must be unique within your space.

  5. Choose Create project.

Now that you have an empty project, the next step is to create a source repository.

Create a source repository

Create a source repository to store and collaborate on your project's code. Project members can clone this repository to their local computers to work on code. Alternatively, you can choose to link a repository hosted in a supported service, but that is not covered in this tutorial. For more information, see Linking a source repository.

To create a source repository
  1. Open the CodeCatalyst console at https://codecatalyst.aws/.

  2. Navigate to your project.

  3. In the navigation pane, choose Code, and then choose Source repositories.

  4. Choose Add repository, and then choose Create repository.

  5. In Repository name, provide a name for the repository. In this guide, we use codecatalyst-source-repository, but you can choose a different name. Repository names must be unique within a project. For more information about requirements for repository names, see Quotas for source repositories in CodeCatalyst.

  6. (Optional) In Description, add a description for the repository that will help other users in the project understand what the repository is used for.

  7. (Optional) Add a .gitignore file for the type of code you plan to push.

  8. Choose Create.


    CodeCatalyst adds a README.md file to your repository when you create it. CodeCatalyst also creates an initial commit for the repository in a default branch named main. You can edit or delete the README.md file, but you can't change or delete the default branch.

You can quickly add code in your repository by creating a Dev Environment. For this tutorial, we recommend that you create a Dev Environment using AWS Cloud9, and choose the option to create a branch from the main branch when creating the Dev Environment. We use the name test for this branch, but you can enter a different branch name if you prefer.

To create a Dev Environment with a new branch
  1. Open the CodeCatalyst console at https://codecatalyst.aws/.

  2. Navigate to the project where you want to create a Dev Environment.

  3. Choose the name of the repository from the list of source repositories for the project. Alternatively, in the navigation pane, choose Code, choose Source repositories, and choose the repository for which you want to create a Dev Environment.

  4. On the repository home page, choose Create Dev Environment.

  5. Choose a supported IDE from the drop-down menu. See Supported integrated development environments for Dev Environments for more information.

  6. Choose the repository to clone, choose Work in new branch, enter a branch name into the Branch name field, and choose a branch off of which to create the new branch from the Create branch from drop-down menu.

  7. Optionally, add an alias for the Dev Environment.

  8. Optionally, choose the Dev Environment configuration edit button to edit the Dev Environment's compute, storage, or timeout configuration.

  9. Choose Create. While your Dev Environment is being created, the Dev Environment status column will display Starting, and the status column will display Running once the Dev Environment has been created. A new tab will open with your Dev Environment in the IDE of your choice. You can edit code and commit and push your changes.

Create a workflow to build, test, and deploy a code change

In CodeCatalyst, you organize the building, testing, and deployment of your applications or services in workflows. Workflows consist of actions and can be configured to run automatically after specified source repository events occur, such as code pushes or opening or updating a pull request. For more information about workflows, see Build, test, and deploy with workflows.

Follow the instructions in Getting started with workflows in CodeCatalyst to create your first workflow.

Invite someone to your project

Now that you've set up your custom project, invite others to work with you.

To invite someone to your project
  1. Navigate to the project to which you want to invite users.

  2. In the navigation pane, choose Project settings.

  3. On the Members tab, choose Invite new member.

  4. Type the email addresses of the people you want to invite as users for your project. You can type multiple email addresses separated by a space or a comma. You can also choose from members of your space who are not members of the project.

  5. Choose the role for the user.

    When you have finished adding users, choose Send.

Create issues to collaborate on and track work

CodeCatalyst helps you track features, tasks, bugs, and any other work involved in your project with issues. You can create issues to track needed work and ideas. By default, when you create an issue it is added to your backlog. You can move issues to a board where you track work in progress. You can also assign an issue to a specific project member.

To create an issue for a project
  1. Open the CodeCatalyst console at https://codecatalyst.aws/.

    Make sure that you are navigating in the project where you want to create issues. To view all projects, in the navigation pane, choose Amazon CodeCatalyst, and if needed, choose View all projects. Choose the project where you want to create or work with issues.

  2. In the navigation pane, choose Track, and then choose Backlog.

  3. Choose Create issue.

  4. In Issue title, provide a name for the issue. Optionally provide a description of the issue. Choose the status, priority, and estimate for the issue if desired. You can also assign the issue to a project member from the list of project members.

  5. Choose Save.

After you have created issues, you can assign them to project members, estimate them, and track them on a Kanban board. For more information, see Issues in CodeCatalyst.