https://github.com/nickvisionapps/application
Create new Nickvision applications
https://github.com/nickvisionapps/application
Last synced: about 1 year ago
JSON representation
Create new Nickvision applications
- Host: GitHub
- URL: https://github.com/nickvisionapps/application
- Owner: NickvisionApps
- License: gpl-3.0
- Created: 2021-12-31T00:05:17.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-17T10:39:21.000Z (about 1 year ago)
- Last Synced: 2025-04-18T01:16:17.314Z (about 1 year ago)
- Language: C++
- Homepage:
- Size: 5.3 MB
- Stars: 39
- Watchers: 5
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
# Application

**Create new Nickvision applications**
## Features
- A template for creating cross-platform desktop apps in C++
- GNOME (Linux) support through GTK4/libadwaita
- Universal (Windows, Linux) support through QT
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how can you help the project and how to provide information so we can help you in case of troubles with the app.
## Building Manually
Application uses `vcpkg` to manage its dependencies and `cmake` as its build system.
Ensure both `vcpkg` and `cmake` are installed on your system before building.
A C++20 compiler is also required to build Application.
**If building the GNOME version, `blueprint-compiler` must be installed from your system package manager as it is not available on `vcpkg`.**
### Configuring vcpkg
1. Set the `VCPKG_ROOT` environment variable to the path of your vcpkg installation's root directory.
#### Windows
1. Set the `VCPKG_DEFAULT_TRIPLET` environment variable to `x64-windows`
1. Run `vcpkg install libnick qtbase qtsvg qttools qlementine qlementine-icons`
#### Linux (GNOME)
1. Set the `VCPKG_DEFAULT_TRIPLET` environment variable to `x64-linux`
1. Run `vcpkg install libnick libxmlpp`
#### Linux (Qt)
1. Set the `VCPKG_DEFAULT_TRIPLET` environment variable to `x64-linux`
1. Run `vcpkg install libnick qtbase qtsvg qttools qlementine qlementine-icons`
### Building
1. First, clone/download the repo.
1. Open a terminal and navigate to the repo's root directory.
1. Create a new `build` directory and `cd` into it.
#### Windows
1. From the `build` folder, run `cmake .. -G "Visual Studio 17 2022"`.
1. From the `build` folder, run `cmake --build . --config Release`.
1. After these commands complete, Application will be successfully built and its binaries can be found in the `org.nickvision.application.qt/Release` folder of the `build` folder.
#### Linux (GNOME)
1. From the `build` folder, run `cmake .. -DCMAKE_BUILD_TYPE=Release -DUI_PLATFORM=gnome`.
1. From the `build` folder, run `cmake --build .`.
1. After these commands complete, Application will be successfully built and its binaries can be found in the `org.nickvision.application.gnome` folder of the `build` folder.
#### Linux (Qt)
1. From the `build` folder, run `cmake .. -DCMAKE_BUILD_TYPE=Release -DUI_PLATFORM=qt`.
1. From the `build` folder, run `cmake --build .`.
1. After these commands complete, Application will be successfully built and its binaries can be found in the `org.nickvision.application.qt` folder of the `build` folder.
## Code of Conduct
This project follows the [GNOME Code of Conduct](https://conduct.gnome.org/).
