Getting Started

Getting Started

A minimalistic but powerful C++ build system that reads from a simple configuration file

View on GitHub

Getting Started with Bodge

Installation

Download Pre-built Binaries

1. Go to the Releases page
2. Download the appropriate binary for your platform
3. Add it to your system PATH

Build from Source

Prerequisites

• GCC or Clang compiler with C++17 support
• Git (for cloning the repository)

Quick Build

git clone https://github.com/el-dockerr/bodge.git
cd bodge
make all  # Linux/macOS
# or
.\make.bat  # Windows

Your First Project

Let’s create a simple “Hello World” project:

1. Create Project Structure

my-project/
├── .bodge
└── src/
    └── main.cpp

2. Create main.cpp

#include <iostream>

int main() {
    std::cout << "Hello, Bodge!" << std::endl;
    return 0;
}

3. Create .bodge Configuration

name: Hello World
compiler: g++
output_name: hello
cxx_flags: -std=c++17, -Wall, -O2
sources: src/main.cpp

4. Build and Run

cd my-project
bodge              # Build the project
./hello            # Run the executable (Linux/macOS)
# or
hello.exe          # Run the executable (Windows)