Project Templates

Start each project from the template named in the assignment. The template includes the build, debugging, formatting, and Worklog settings used by Chemeketa CS courses.

Choose a template

• Basic Project contains a main.cpp program.
• Unit Test Project contains a doctest test program.
• Combo Project contains both a main program and a doctest test program.

Use the Basic Project when your instructor does not specify a template.

Create a GitHub repository

This is the recommended method for Codespaces and local development.

1. Open the appropriate template repository.
2. Select Use this template, then Create a new repository.
3. Name the repository and make it private.
4. Create it, then either open a Codespace or clone it to your computer.

Create a project without GitHub

Use this method only when you need a project that will remain completely local.

1. Open the appropriate template repository.

2. Open the Releases page and select the release marked Latest.

   

3. Download the prepared project ZIP attached to that release.

4. Extract it and rename the project folder.

Do not use GitHub's general Download ZIP button. That archive does not include the prepared Git history needed by Chemeketa Worklog.

Avoid spaces in project names and do not place active projects in OneDrive, iCloud, or another synchronized folder.

Use the included project settings

Keep the template's Makefile and .vscode folder with your project. Together, they:

• build C++20 projects through a Makefile;
• provide VS Code build and debugging commands;
• use MinGW GCC on Windows, Homebrew GCC on macOS, and GCC on Linux;
• enable Chemeketa Worklog to make frequent local commits; and
• provide a Codespaces development container.

Worklog creates commits but does not push them to GitHub. Follow the steps in Git and Worklog to save those commits to GitHub.