HomelabARR Landing Page

The official landing page for HomelabARR - A comprehensive Docker-based application for managing and monitoring your homelab container applications.

🔗 Live Demo

🚀 Features

• Modern Design: Built with Astro for optimal performance and SEO
• Interactive Gallery: Showcase application screenshots with PhotoSwipe integration
• Real-time Stats: Display GitHub stars and Discord member counts
• Responsive Layout: Fully responsive design that works on all devices
• Docker Ready: Easy deployment with Docker and nginx

🛠️ Tech Stack

• Astro - Static Site Generator
• TypeScript - Type Safety
• PhotoSwipe - Image Gallery
• Docker - Containerization
• Nginx - Web Server

🏃‍♂️ Quick Start

   git clone https://github.com/smashingtags/homelabarr-site.git
   cd homelabarr-site
   docker compose -f homelabarr-site.yml up -d

The app will be available on http://localhost:8087

🏃‍♂️ Local Development

1. Clone the repository:

   git clone https://github.com/smashingtags/homelabarr-site.git
   cd homelabarr-site

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open http://localhost:4321 in your browser

🐳 Docker Deployment

Using Docker Compose (Recommended)

1. Clone the repository
2. Run with docker-compose:

   docker-compose up -d

Manual Docker Build

1. Build the image:

   npm run docker:build

2. Run the container:

   npm run docker:run

📦 Project Structure

/
├── public/          # Static assets
├── src/
│   ├── components/  # UI components
│   ├── layouts/     # Page layouts
│   └── pages/       # Page components
├── Dockerfile       # Docker configuration
└── nginx.conf       # Nginx configuration

🔧 Configuration

Environment Variables

No environment variables are required for basic setup. The site is completely static.

Nginx Configuration

The default nginx configuration in nginx.conf includes:

• Gzip compression
• Cache control headers
• CORS headers
• Static asset optimization

📝 License

MIT License

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📞 Support

• Discord Server
• Demo Site
• GitHub Issues

🌟 Related Projects

• HomelabARR Main Repository
• HomelabARR Frontend
• HomelabARR Backend