Parch

Getting Started

Welcome to Parch development. Parch GNU/Linux is an Arch Linux-based distribution focused on usability, Persian-language support, and the KDE Plasma desktop. This section takes you from an empty machine to your first contribution.

Introduction to Parch

What Parch is, how it relates to Arch Linux, and which parts the Parch team maintains itself.

What Parch adds to Arch

The concrete software, infrastructure, and engineering behind the distribution, with links to every repository.

Set up your workstation

Install Parch or Arch, add the world repository, and install the core build toolchain.

Git workflow

How the Parch GitHub organization is organized and how changes flow.

First app tutorial

Build a small GTK4/libadwaita application from empty directory to installable package.

First package tutorial

Write, build, and test your first PKGBUILD with makepkg.

First ISO tutorial

Build a bootable Parch ISO from the template profile (opens the ISO section).

Contribution workflow

Where to report bugs, propose changes, and get your work reviewed.

Common problems

The errors everyone hits first, with fixes.

The three core skills

Almost everything in this portal builds on three skills. Learn them in this order:

  1. Build packages. Every piece of Parch software, from the kernel to the Welcome app, ships as a pacman package. See Packaging.
  2. Build ISO images. Releases and custom editions are assembled with the archiso tool from per-edition profiles. See ISO Building.
  3. Follow the HIG. First-party apps share one design language. See Human Interface Guidelines.

Continue in Getting Started

Introduction to ParchWhat Parch GNU/Linux is, where it comes from, and how it relates to Arch Linux.Set up your workstationInstall Parch or Arch, add the world repository, and install the build toolchain.What Parch adds to ArchThe concrete software, infrastructure, and engineering Parch builds on top of Arch, with receipts.Git workflowHow the Parch GitHub organization is structured and how changes flow.Your first appBuild a small GTK4/libadwaita application in Python and package it, from zero to installed.Your first packageWrite, build, and test a PKGBUILD with makepkg in fifteen minutes.Contribution workflowWhere to report bugs, propose changes, and get your work reviewed.Common problemsThe errors everyone hits first, with fixes.