C++ Project Starter Template
This is a little quick-start project template for C++ projects which utilise a Core/App project architecture. There are two included projects - one called Core, and one called App. Premake is used to generate project files.
Core builds into a static library and is meant to contain common code intended for use in multiple applications. App builds into an executable and links the Core static library, as well as provides an include path to Core's code.
The Scripts/
directory contains build scripts for Windows and Linux, and the Vendor/
directory contains Premake binaries (currently version 5.0-beta2
).
Getting Started
- Clone this repository or use the "Use this template" button on GitHub to quickly set up your own repository based on this template
App/
andCore/
are the two projects - you can edit the names of these folders and their contents to suit- The three included Premake build files are
Build.lua
,Core/Build-Core.lua
andApp/Build-App.lua
- you can edit these to customise your build configurations, edit the names of your projects and workspace/solution, etc. - Open the
Scripts/
directory and run the appropriateSetup
script to generate projects files. You can edit the setup scripts to change the type of project that is generated - out of the box they are set to Visual Studio 2022 for Windows and gmake2 for Linux.
Note that no macOS setup script is currently provided; you can duplicate the Linux script and adjust accordingly.
Included
- Some example code (in
App/Source
andCore/Source
) to provide a starting point and test - Simple
.gitignore
to ignore project files and binaries - Premake binaries for Win/Mac/Linux (
v5.0-beta2
)
License
- UNLICENSE for this repository (see
UNLICENSE.txt
for more details) - Premake is licensed under BSD 3-Clause (see included LICENSE.txt file for more details)