<p align="center">
  <img src="logo.svg" alt="Parch Linux Void Repository Logo" width="128" height="128">
</p>

<h1 align="center">Parch Linux Void Repository</h1>

<p align="center">
  <b>The Unstable & Pre-release Testing Repository for Parch Linux</b>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Status-Unstable%2FTesting-ff4500?style=for-the-badge" alt="Status: Unstable/Testing">
  <img src="https://img.shields.io/badge/Architecture-x86__64-00eaff?style=for-the-badge" alt="Architecture: x86_64">
  <img src="https://img.shields.io/badge/Distro-Parch%20Linux-00ff80?style=for-the-badge" alt="Parch Linux">
</p>

---

## 🌌 Overview

**Parch Linux `void`** (`[void]`) is the official unstable repository for the Parch Linux distribution. It acts as the testing ground and staging area for pre-release applications, experimental software, and upcoming features created or packaged by the **Parch Linux Team** and the **community**.

Packages in `void` undergo active testing and feedback collection before being stabilized and promoted to the main `world` repository.

> [!WARNING]
> **Use at your own risk!**  
> `[void]` contains pre-release, experimental, and unstable software. It may contain bugs, incomplete features, or breaking changes. It is recommended primarily for developers, testers, and power users who want early access to upcoming Parch Linux software and are comfortable troubleshooting issues.

---

## ⚡ Mirror URL

The repository is synchronized and hosted on the official Parch Linux mirror infrastructure:

```text
https://mirror.parchlinux.ir/$repo/$arch
```

For `x86_64` systems, the repository path resolves to:
```text
https://mirror.parchlinux.ir/void/x86_64
```

---

## 🚀 How to Enable `[void]` Repository

To start testing pre-release software from `[void]`, add the repository entry to your `/etc/pacman.conf` file.

### 1. Edit `/etc/pacman.conf`

Open `/etc/pacman.conf` with root privileges in your preferred text editor:

```bash
sudo nano /etc/pacman.conf
```

### 2. Add the `[void]` Repository Entry

Append the following configuration block to `/etc/pacman.conf` (place it above or below your existing Parch Linux repositories):

```ini
[void]
SigLevel = Optional TrustAll
Server = https://mirror.parchlinux.ir/$repo/$arch
```

### 3. Update Package Databases

Synchronize your package databases to index packages from `[void]`:

```bash
sudo pacman -Sy
```

### 4. Install Packages

You can now install packages available in the `[void]` repository. For example:

```bash
sudo pacman -S <package-name>
```

To view all packages available in `[void]`:

```bash
pacman -Sl void
```

---

## 🔄 Package Lifecycle & Promotion Workflow

```mermaid
flowchart LR
    A[Pre-release / Beta Code] --> B[Build Package]
    B --> C[Push to void repo]
    C --> D[Community Testing & QA]
    D -->|Bug Fixes / Feedback| C
    D -->|Verified Stable| E[Promote to world repo]
```

1. **Development & Submission**: The Parch Linux Team or community members package pre-release software or new utilities.
2. **Staging in `void`**: Packages are published to the `[void]` repository for public testing.
3. **Feedback & Verification**: Users test the packages, report bugs, and verify system integration.
4. **Promotion to `world`**: Once verified and deemed stable, the package is moved to the primary `world` repository for all Parch Linux users.

---

## 🤝 Contributing & Submitting Packages

We welcome community testing and package contributions!

- **Test & Report**: If you encounter issues while testing software from `[void]`, please submit bug reports on our issue trackers or community channels.
- **Submit Packages**: Interested in packaging your software or contributing pre-release builds to `[void]`? Reach out to the Parch Linux Team on our official community platforms.

---

## 🌐 Community & Support

Stay connected with the Parch Linux community:

- **Website**: [parchlinux.ir](https://parchlinux.ir)
- **Mirror**: [mirror.parchlinux.ir](https://mirror.parchlinux.ir)
- **GitHub**: [github.com/parchlinux](https://github.com/parchlinux)

---

<p align="center">
  Crafted with ❤️ by the <b>Parch Linux Team</b>
</p>
