Creating a Project

Once Mach is installed, you can create a new project using the Mach CLI.

Create a Project

Open a terminal in the directory where you want to create your project and run:

mach new hello-world

Mach creates a new hello-world directory containing a ready-to-build application.

Move into the project directory:

cd hello-world

Project Structure

A newly created Mach project has the following structure:

hello-world/
├── src/
│   └── main.cpp
├── .gitignore
└── CMakeLists.txt

CMakeLists.txt

The CMakeLists.txt file contains the CMake configuration used to build your application and link it with Mach.

src/

The src directory contains your application’s source code.

src/main.cpp

main.cpp is the entry point of your application. This is where the Mach application is created and configured.

.gitignore

Specifies files and directories that Git should ignore, including build artifacts generated by Mach.

Tip

You can use mach n as a shorter alias for mach new:

---

Next, you’ll take a closer look at the endpoint included in your new application.