🏠 Homelab Dashboard

A premium, fully native dual-platform solution for monitoring and managing your personal Homelab ecosystem. This project features two distinct, purpose-built native applications sharing the same design soul but optimized for their respective platforms.

---

Table of Contents

• Highlights
• iOS Version
• Android Version
• Project & Author
• Install via AltStore / SideStore
• Getting Started
• Integrated Services
• Usage & License

---

Highlights

• 11 integrated services — Portainer, Pi-hole, Beszel, Gitea, Nginx Proxy Manager, AdGuard DNS, Healthcheck, Patchmon, Jellystat, Tailscale, Bookmarks.
• Multi-instance support — Add multiple instances of the same service and switch between them seamlessly.
• Cyberpunk mode — Toggle a unique cyberpunk visual theme for your service cards.
• Multilingual — English, Italian, French, Spanish, German — auto-detected from your system language.
• 2 native apps — Swift 6 + SwiftUI (iOS) and Kotlin + Jetpack Compose (Android).

---

📱 iOS Version (Swift Native + Liquid Glass)

Developed with Swift 6 and SwiftUI, utilizing the latest native iOS 26 technologies. The UI is built around the Liquid Glass design system, leveraging frosted glass effects and fluid animations for a high-end feel.

Dashboard	Portainer	Nginx Proxy	Beszel	Pi-hole

Gitea	AdGuard DNS	Healthcheck	Patchmon	Jellystat	Bookmarks

View all iOS screenshots

Portainer

Nginx Proxy Manager

Beszel

AdGuard DNS

Healthcheck

Patchmon

Jellystat

---

🤖 Android Version (Kotlin Native + Material Expressive 3)

Built with Kotlin and Jetpack Compose, following the Material Expressive 3 design language. It focuses on dynamic color integration, haptic-rich interactions, and modern Android architecture.

Dashboard	Portainer	Beszel	Gitea	Nginx Proxy

Pi-hole	AdGuard DNS	Healthcheck	Patchmon	Jellystat	Bookmarks

View all Android screenshots

Portainer

Beszel

Nginx Proxy Manager

Pi-hole

AdGuard DNS

Healthcheck

Patchmon

Jellystat

Bookmarks

---

👨‍🎓 Project & Author

This project is a solo endeavor developed by a single University Student. It was born from the need for a beautiful, unified way to manage home servers without sacrificing the performance and "feel" of native development.

☕ Support the Project

If you find this dashboard useful, consider supporting my studies with a donation. Every bit helps!

EVM Wallet (Ethereum, BSC, Polygon, etc.): 0x649641868e6876c2c1f04584a95679e01c1aaf0d

---

📲 Install via AltStore / SideStore

You can install the iOS app directly on your iPhone without Xcode using AltStore or SideStore.

1. Copy the source URL:

   https://raw.githubusercontent.com/JohnnWi/homelab-project/main/apps.json
   

2. Open AltStore or SideStore on your device.
3. Go to Sources → Add Source and paste the URL above.
4. Find Homelab in the source and tap Install.

The app will update automatically when new versions are released.

Note: SideStore can re-sign the app automatically without needing a Mac every 7 days.

---

🚀 Getting Started

🍎 Build for iOS

1. Open Xcode: Open HomelabSwift/Homelab.xcodeproj in Xcode 26+.
2. Signing: Go to the project settings, select the Homelab target, and under Signing & Capabilities, select your development team.
3. Run: Connect your iPhone or select a simulator and press Cmd + R to build and run.

🤖 Build for Android

1. Open Android Studio: Import the HomelabAndroid folder.
2. Setup: Let Gradle sync and download all dependencies.
3. Run: Connect your Android device or start an emulator and press Shift + F10.

---

✨ Integrated Services

🐳 Portainer

Monitor your Docker environments in real-time. Peek into container statuses, CPU/Memory usage, and perform quick actions like Start, Stop, or Restart directly from your mobile device.

🛡️ Pi-hole

Keep your network clean. View real-time query statistics, see your total blocked domains, and toggle ad-blocking on the fly with customizable timers.

📊 Beszel

A lightweight, efficient system monitor. Track global CPU, Memory, and Disk usage across all your connected nodes with beautiful percentage-based visualizations.

🦊 Gitea

Manage your code natively. Browse repositories, view contribution heatmaps, read code files with full syntax highlighting, and keep track of your latest commits.

🔐 Tailscale

Integrated Tailscale support helps you securely reach your homelab from anywhere, with quick launch actions and connection status surfaced directly inside the app experience.

🔀 Nginx Proxy Manager

Manage your reverse proxy directly from your phone. Browse proxy hosts, redirection hosts, dead hosts, streams, access lists, and SSL certificates — all in one native interface.

🛡️ AdGuard DNS

Monitor and manage your AdGuard Home DNS server. View real-time query statistics, check filtering status, and control DNS protection directly from your phone.

💓 Healthcheck

Monitor the uptime and health of your services. View check statuses, response times, and get notified when services go down — all from a clean native interface.

🩹 Patchmon

Track software updates and patches across your infrastructure. Monitor version status, pending updates, and keep your homelab systems up to date from one place.

🍿 Jellystat

Monitor your Jellyfin media server usage. Track active streams, playback statistics, and library activity from a clean native interface.

🔖 Bookmarks

Keep all your most-used homelab links in one place with a native bookmarks feature that supports organization, quick access, and a cleaner daily workflow.

---

📜 Usage & License

• ✅ Authorized: Personal use, modifications for personal homelab environments, and code contributions/improvements.
• ❌ NOT Authorized: Use of this code in paid applications, apps with subscriptions, or any form of commercial redistribution.

The code is free to explore and improve for the community. Build something great for your home!