A template for developing stunning desktop applications with...

• GTK4 and Adwaita beauty
• Flatpak and Nix reproducibility
• Rust safety and developer experience

For now this template has a bunch of strings that must be set manually in different places (both file names and strings). To make this job easier, I replaced them with these placeholders:

• ^AUTHOR_NAME^ (e.g. Nika)
• ^AUTHOR_EMAIL^ (e.g. [email protected])
• ^TOP_LEVEL_DOMAIN^ (e.g. moe or io)
• ^DOMAIN_NAME^ (e.g. nikableh or github.username)
• ^APP_NAME^ (e.g. AwesomeApplication)
• ^URL^ (e.g. https://github.com/nikableh/AwesomeApplication)
• ^URL_ISSUES^ (e.g. https://github.com/nikableh/AwesomeApplication/issues)
• ^EXECUTABLE^ (e.g. awesome-application)
• ^SHORT_DESCRIPTION^ (e.g. Short description of the application)
• ^LONG_DESCRIPTION^ (e.g. Long description of the application)

To compile and run the application locally (for development purposes) use Nix and its development shell. This way you get all the necessary dependencies and avoid having to recompile the whole application from scratch.

nix develop
./dev.sh

You can also run ./dev.sh without nix develop shell, but you then have to manually ensure the correctness of all dependencies.

Alternatively, you can run application with a single command. But this would do a full clean rebuild for any change in the source code.

nix run

Flatpak would rebuild the project from scratch each time, which is not very pleasant in situations when you need iterate rapidly.

services.flatpak.enable = true;

flatpak install --user org.gnome.Sdk//48 org.gnome.Platform//48 org.freedesktop.Sdk.Extension.rust-stable//24.08 org.freedesktop.Sdk.Extension.llvm18//24.08
flatpak-builder --user --force-clean flatpak_app build-aux/^TOP_LEVEL_DOMAIN^.^DOMAIN_NAME^.^APP_NAME^.Devel.json
flatpak-builder --run flatpak_app build-aux/^TOP_LEVEL_DOMAIN^.^DOMAIN_NAME^.^APP_NAME^.Devel.json ^EXECUTABLE^

This is a list of resources you better familiarize yourself with, if you want your application to be perfect.

• Ensure compliance with GNOME Circle guidelines
• Ensure compliance with GNOME Human Interface Guidelines

This project is under the GPL-3.0-only license.

This project follows the GNOME Code of Conduct.