Skip to content

This page shows how you can get started with a simple hello world application.

1. Include

Starting with an empty main.cpp file, first add #define CROW_MAIN then #include "crow.h" or #include "crow_all.h" if you're using the single header file.

Note

If you're using multiple C++ source files make sure to have CROW_MAIN defined only in your main source file.

2. App declaration

Next Create a main() and declare a crow::SimpleApp inside, your code should look like this

int main()
{
    crow::SimpleApp app;
}
The App (or SimpleApp) class organizes all the different parts of Crow and provides the developer (you) a simple interface to interact with these parts. For more information, please go here.

3. Adding routes

Once you have your app, the next step is to add routes (or endpoints). You can do so with the CROW_ROUTE macro.

CROW_ROUTE(app, "/")([](){
    return "Hello world";
});
For more details on routes, please go here.

4. Running the app

Once you're happy with how you defined all your routes, you're going to want to instruct Crow to run your app. This is done using the run() method.

app.port(18080).multithreaded().run();
Please note that the port() and multithreaded() methods aren't needed, Though not using port() will cause the default port (80) to be used.

Putting it all together

Once you've followed all the steps above, your code should look similar to this

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
#define CROW_MAIN //let the compiler know this is your main cpp file
#include "crow.h"
//#include "crow_all.h"

int main()
{
    crow::SimpleApp app; //define your crow application

    //define your endpoint at the root directory
    CROW_ROUTE(app, "/")([](){
        return "Hello world";
    });

    //set the port, set the app to run on multiple threads, and run the app
    app.port(18080).multithreaded().run();
}
After building and running your .cpp file, you should be able to access your endpoint at http://localhost:18080. Opening this URL in your browser will show a white screen with "Hello world" typed on it.