This guide walks you through building and running the Cosmic Store from source using Flatpak.

Make sure your system is up to date:

sudo apt update && sudo apt upgrade -y

Install Rust using rustup:

curl https://sh.rustup.rs -sSf | sh -s -- -y
source "$HOME/.cargo/env"

Install required system packages:

sudo apt install -y \
  git \
  flatpak \
  flatpak-builder \
  libflatpak-dev \
  libgtk-4-dev \
  libadwaita-1-dev \
  build-essential \
  pkg-config \
  libssl-dev \
  libxkbcommon-dev \
  just

(Optional) Install the latest version of just via Cargo:

cargo install just

git clone https://github.com/pop-os/cosmic-store
cd cosmic-store

Make the build script executable:

chmod +x flatpak.sh

Run the build:

./flatpak.sh

After building, run the app with:

flatpak run com.system76.CosmicStore

• Ensure Flatpak is set up:

  flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

• If you encounter issues, try updating Rust:

  rustup update