CodeVerse Linux Distro

CodeVerse Linux is a community-driven, Arch-based Linux distribution developed under the CodeVerse Hub organization.

The goal of this project is to build a minimal, fast, and developer-focused Linux distro with first-class support for Wayland compositors, especially Hyprland and Niri.

This is not a personal distro. It is a collaborative open-source project where anyone from the community can contribute.

---

Project Goals

• Arch Linux base (simple, rolling, upstream-focused)
• Wayland-first experience
• Official support for:
  • Hyprland
  • Niri
• Minimal defaults, no bloat
• Developer-friendly setup
• Clean configs and sensible defaults
• Easy to extend and customize
• Fully community maintained

---

Target Audience

• Linux users interested in Wayland
• Developers who want a clean environment
• Arch users who prefer curated defaults
• Contributors who want real open-source experience

Beginner and advanced users are both welcome.

---

What This Project Is

• A learning-oriented but serious distro project
• A collaborative effort across multiple domains
• A place to contribute to:
  • Linux internals
  • Shell scripts
  • Package management
  • Wayland configuration
  • Documentation
  • Design and UX decisions

---

What This Project Is NOT

• A beginner-friendly installer-focused distro (yet)
• A one-person hobby project
• A bloated or themed distro with heavy customization
• A replacement for Arch Linux itself

---

Planned Components

• Base Arch install scripts
• Wayland compositor profiles
  • Hyprland default profile
  • Niri default profile
• Minimal system services
• Developer tools (optional)
• Documentation and setup guides
• Branding and identity (logo, name usage, visuals)

---

Repository Structure (Planned)

.
├── scripts/           # Install and setup scripts
├── configs/           # Wayland and system configs
│   ├── hyprland/
│   └── niri/
├── packages/          # Package lists and meta packages
├── docs/              # Documentation
├── assets/            # Branding and visuals
└── README.md

Structure may evolve as the project grows.

---

Contribution

This project is open to contributions.

You can help with:

• Core system scripts
• Wayland compositor configs
• Package selection
• Documentation
• Testing
• Design and creative direction

Please read CONTRIBUTING.md before starting.

All meaningful contributors will receive the @Contributors role on the CodeVerse Hub Discord server.

---

Getting Started (For Contributors)

1. Fork this repository
2. Read the documentation
3. Check open issues
4. Pick a task or open a discussion
5. Create a feature branch
6. Submit a pull request

If you are unsure where to start, look for issues labeled good first issue.

---

Current Status

This project is in early development.

Things may change rapidly.
Breaking changes are expected at this stage.

---

License

License will be added soon.
Until then, assume all rights are reserved.

---

Community

This project is part of CodeVerse Hub.

• GitHub Organization: https://github.com/TheCodeVerseHub
• Contributions and discussions happen openly on GitHub
• Coordination and discussion also happen on the CodeVerse Hub Discord server

---

This distro is built by the community, for the community.
If you want to learn, build, and collaborate on real Linux internals, you are welcome here.