Qt5 Widgets Project Template – Cross‑Platform (CMake + GitHub Actions)

A minimal and ready-to-use Qt5 Widgets project template designed for cross‑platform desktop development.

This template provides:

• Qt5 Widgets–based GUI application (minimal structure)
• CMake-based cross‑platform project setup
• macOS .app bundle support (auto‑generated Info.plist)
• GitHub Actions workflow for automatic builds (OS × Qt version matrix)
• Automatic Qt installation using aqtinstall
• Qt path auto‑detection (Linux / Windows / macOS)
• Unified build output directory: build/release
• Automatic copying of config/ and lib/ (if present)
• Automatic inclusion of .cpp / .h / .ui files added under src/

Supported platforms:

• Linux
• Windows
• macOS

Included files:

• CMakeLists.txt
• cmake/Info.plist.in
• config/app.ini
• src/main.cpp
• src/MainWindow.cpp / MainWindow.h
• .github/workflows/build.yml
• .gitignore
• README.md (English)
• README_JP.md (Japanese)

How to use:

1. Extract the project
2. Set your Qt path and build with CMake
3. The output will be generated under build/release
4. Enable GitHub Actions to run automatic CI builds

Recommended for:

• Developers starting Qt5 Widgets + CMake desktop apps
• Those who want a stable Qt5 LTS environment (5.12 / 5.15)
• Cross‑platform development (Linux / Windows / macOS)
• Developers who want CI with GitHub Actions
• Anyone who wants to skip initial project setup
• Teams looking for a base for commercial applications

Notes:

• This template provides a development foundation only
• Deployment tools (signing, notarization, macdeployqt, etc.) are not included
• Qt5 is not supported on macOS CI (GitHub Actions) due to Apple Silicon runner limitations, but works on local Intel Macs

License:

Commercial use allowed.
You may publish or sell applications built with this template.
Redistribution of the template itself is prohibited.

Support:

If you find issues or have questions, feel free to contact me.