Expresso ☕️

A C++ backend framework designed for web applications. A few features include:

• Simple and easy to use API ✨
• Built-in HTTP server 🌐
• Out of the box multi-threading support 🧵
• Expandable custom middleware 🧩

It is pretty straightforward and if you are familiar with the Express.js framework, you will feel right at home, as the API is very similar, which is my goal? 🎯

Installation 🚀

0. Make sure you have the a c++ compiler (such as g++ or clang) installed on your system.

Install g++

sudo apt install g++

Install clang

sudo apt install clang

1. Install the make utilities to build the binary:

sudo apt install cmake make

2. Clone the repository:

git clone git@github.com:coding-cpp/expresso.git

3. Clone the submodules:

cd expresso
git submodule init
git submodule update

4. Make a .env file in the root directory of the project and add the environment variables present in the .env.sample file in it.

5. Build the project:

mkdir build && cd build
cmake ..
make

6. Run the server:

./server

Example

You can find an example of how to use the framework in the example directory.

Docker 🐳

You can also run the server using Docker. Make sure you have Docker installed on your system.

1. Build the Docker image:

docker build -f docker/build.dockerfile -t expresso .

2. Run the Docker container:

docker run -p 8000:8000 -e PORT=8000 expresso

Alternatively, you can use the pre-built Docker image from Docker Hub (supports both amd64 and arm64 architectures):

docker run -p 8000:8000 -e PORT=8000 jadit19/expresso:latest

If you prefer to use Docker Compose, you can use the provided docker compose file and run it using the following command:

docker compose -f docker/compose.yaml up

Contributing 🤝

If you would like to contribute to the project, feel free to fork the repository and submit a pull request. I am always open to new ideas and suggestions. 🚀

Bugs and Issues

If you encounter any bugs or issues, feel free to open an issue on the repository. This is a work in progress and since I am the only one working on it, that too in my spare time, I might not have the time to fix it right away, but I will try my best to get to it as soon as possible. 🐛🔧