Omarchy Hub

A community-driven website for collecting and sharing themes, setups, resources, and links for Omarchy - the opinionated Arch + Hyprland setup by DHH. Currently, omarchy-hub showcases 110 workstation setups, 71 beautiful themes, 15 useful resources and more from the community.

🌐 Live website: omarchy.deepakness.com
📸 Workstation setup gallery: SETUPS.md
🎨 Theme collection: THEMES.md

Project structure

├── app/                    # Next.js App Router pages
│   ├── layout.tsx          # Root layout component
│   ├── page.tsx            # Homepage with featured content
│   ├── themes/             # Themes section
│   │   ├── layout.tsx      # Themes layout
│   │   └── page.tsx        # Themes listing page
│   ├── setups/             # Setups section
│   │   ├── layout.tsx      # Setups layout
│   │   └── page.tsx        # Setups listing page
│   └── resources/          # Resources section
│       ├── layout.tsx      # Resources layout
│       └── page.tsx        # Resources listing page
├── data/                   # JSON data files
│   ├── themes.json         # Themes data
│   ├── setups.json         # Setups data
│   ├── resources.json      # Resources data
│   ├── releases.json       # Omarchy releases, scrapes automatically
│   └── links.json          # Links data
├── scripts/                # Automation scripts
│   ├── generate-docs.js    # Generate documentation from JSON data
│   ├── fetch-releases.js   # Fetch latest Omarchy releases
│   └── optimize-images.js  # Optimize setup images
├── public/                 # Static assets
│   └── setups/             # Setup screenshots
├── SETUPS.md               # Setup gallery
├── THEMES.md               # Theme collection
├── RESOURCES.md            # Resources collection
└── CONTRIBUTING.md         # Contribution guidelines

Contributing content

We welcome contributions from the community! There are several ways to contribute:

🚀 Quick contribution (recommended)

For Beginners: Use our GitHub issue templates for easy submission:

• 🖥️ Submit a Setup - Share your Omarchy workstation
• 🎨 Submit a Theme - Share custom color schemes
• 📚 Submit a Resource - Share guides and tutorials
• 🔗 Submit a Link - Suggest useful links

🔧 Developer contribution

For Developers: Submit pull requests directly:

1. Fork the repository
2. Add your content to the appropriate JSON file in /data/
3. Follow the data structure guidelines below
4. Submit a pull request

📋 Data structure examples

Setups (data/setups.json):

{
  "id": "unique-id",
  "name": "Setup Name",
  "description": "Brief one-line description of your setup",
  "screenshot": "setups/setup-image.jpg",
  "link": "https://social-post-url.com",
  "device": "Hardware details",
  "category": "Desktop",
  "tags": ["tag1", "tag2"]
}

Themes (data/themes.json):

{
  "id": "unique-id",
  "name": "Theme Name",
  "category": "Dark Theme | Light Theme",
  "link": "https://github.com/username/theme",
  "author": "Author Name",
  "screenshot": "https://screenshot-url.com",
  "tags": ["official", "popular"]
}

Resources (data/resources.json):

{
  "id": "unique-id",
  "name": "Resource Name",
  "description": "Brief one-line description of the resource",
  "category": "Documentation | Article | Discussion | Video | Tool",
  "link": "https://resource-url.com",
  "author": "Author Name",
  "tags": ["guide", "tutorial"]
}

Links (data/links.json):

{
  "name": "Link Name",
  "url": "https://link-url.com"
}

📖 Detailed guidelines

For complete contribution guidelines, see CONTRIBUTING.md.

Community

• 💬 Discussions: GitHub Discussions
• 🐛 Issues: GitHub Issues
• 📧 Contact: @deepakness

Acknowledgments

• DHH for creating Omarchy
• The Arch Linux and Hyprland communities for their amazing work
• All contributors who share their setups, themes, and resources

License

This project is open source and available under the MIT License.