Skip to content

Installation

Zuno is designed to be easy to install and integrate into any modern C++ project. You can install it using CMake Fetch Content, or build it manually from source if you prefer full control.


Section titled “✅ Recommended: Install via CMake Fetch Content”

The easiest way to get started is by using CMake Fetch Content, a feature that allows you to include external projects directly in your CMake configuration.

Add the following lines to your CMakeLists.txt file:

cmake_minimum_required(VERSION 3.16)
project(my_zuno_app)
set(CMAKE_CXX_STANDARD 20)
include(FetchContent)
FetchContent_Declare(
zuno
GIT_REPOSITORY https://github.com/ZunoFramework/zuno.git
GIT_TAG main
)
FetchContent_MakeAvailable(zuno)
add_executable(zuno-app main.cpp)
target_link_libraries(zuno-app PRIVATE zuno)

Run the following commands to build your project:

Terminal window
cmake -B build
cmake --build build

If you prefer to build Zuno manually (e.g. for debugging or contributing), follow these steps:

Terminal window
git clone https://github.com/ZunoFramework/zuno.git
cd zuno
Terminal window
cmake -B build
cmake --build build

Make sure to include the include/ directory and link against the compiled static or shared library.


To confirm that Zuno is installed correctly, try compiling this minimal example:

#include <zuno/zuno.hpp>
int main() {
zuno::App app;
app.get("/", [](auto& req, auto& res) {
res.send("Zuno is working!");
});
app.listen(3000);
}

Compile and run:

Terminal window
cmake -B build
cmake --build build
./build/zuno-app

You should see:

Zuno server running on http://localhost:3000

Now that Zuno is installed, continue with:


Need help? Visit the Contributing page or open a discussion on GitHub.