scratch

A simple C++ starter project for getting going with native game development. Starts with SDL2, ImGui, STB, and Box2D linked and opens a window with the ImGui demo with no configuration. This was originally intended to be a starter for Windows Developers using Visual Studio but makefiles have been added if you want to use Linux or Mac. If you're used to CMAKE, you can also checkout christiannicola's CMAKE Integration Fork!

Windows Instructions:

Visual Studio 2022:

git clone https://github.com/britown88/scratch.git
cd scratch
git submodule update --init
Open scratch.sln in Visual Studio 2022
Click The Green Local Windows Debugger button top center
Start coding in scratch/main.cpp

Microsoft C++ Build Tools:

Install Microsoft C++ Build Tools
Run the Visual Studio Tools Command Prompt of your choice
git clone https://github.com/britown88/scratch.git
cd scratch
git submodule update --init
msbuild /m /t:Clean,Build /p:Configuration=Release /p:Platform=x64 scratch.sln

Notes:

Platform can be Win32 or x64
Configuration can be Debug or Release
The scratch.exe binary will end up in the %Platform%\%Configuration% directory

Msys2:

Install Msys2
Run your preferred MSYS2 MinGW environment
Install prerequisites: pacman -S git make ${MINGW_PACKAGE_PREFIX}-gcc ${MINGW_PACKAGE_PREFIX}-SDL2
git clone https://github.com/britown88/scratch.git
cd scratch
git submodule update --init
make -j$(nproc)
The scratch.exe binary will end up in the bin/ directory

Ubuntu/Debian Linux Instructions:

Install prerequisites: sudo apt-get install git build-essential libsdl2-dev
git clone https://github.com/britown88/scratch.git
cd scratch
git submodule update --init
make -j$(nproc)
The scratch binary will end up in the bin/ directory

macOS Instructions:

Install prerequisites: brew install git make gcc sdl2 coreutils
git clone https://github.com/britown88/scratch.git
cd scratch
git submodule update --init
make -j$(nproc)
The scratch binary will end up in the bin/ directory