A template for developing applications for the COSMIC™ desktop environment.
Log into your GitHub account and click the "Use this template" button above. This will create a new repository in your account. Choose a name for this repository, and then clone it locally onto your system. Make the following changes after cloning it:
Cargo.toml
, change the name
and set your license
and repository
.LICENSE
file containing your chosen software license.cosmic_app_template
portion of i18n/en/cosmic_app_template.ftl
to the new crate name
.justfile
, change the name
and appid
variables with your own.src/app.rs
, change the APP_ID
value in the Application
implementation of the AppModel
.src/app.rs
, change the REPOSITORY
const with the URL to your application's git repository.res/app.desktop
, change the Name=
, Exec=
, and Icon=
fieldsA justfile is included by default with common recipes used by other COSMIC projects. Install from casey/just
just
builds the application with the default just build-release
recipejust run
builds and runs the applicationjust install
installs the project into the systemjust vendor
creates a vendored tarballjust build-vendored
compiles with vendored dependencies from that tarballjust check
runs clippy on the project to check for linter warningsjust check-json
can be used by IDEs that support LSPRefer to the libcosmic API documentation and book for help with building applications with libcosmic.