1. About the Project
2. Mission & Vision
3. Screenshots
4. What's Inside?
5. Getting Started
   • Prerequisites
   • Installation
6. Usage
7. Community Impact
8. Releases
9. Contributing
10. License
11. Contact
12. Acknowledgments

LGamila started as a passion project by Moroccan streamers who wanted to see their community thrive. We recognized that talented Moroccan creators needed better visibility and tools to grow their audience, so we built a comprehensive ecosystem to address these challenges.

Our story: Born from the vibrant Moroccan streaming community, LGamila is more than just a technical solution—it's a collective effort to build the infrastructure our creators deserve. We're streamers building for streamers, understanding the unique challenges and opportunities within our community.

Mission: To provide Moroccan streamers with world-class tools and community support, helping them gain the recognition they deserve and build sustainable streaming careers.

Vision: A future where every talented Moroccan streamer has the resources, visibility, and community support needed to thrive on the global stage.

• 🤝 Community First: Everything we build is designed with our community's needs at the forefront
• 🛠️ Innovation: Creating cutting-edge tools that give Moroccan streamers a competitive advantage
• 🌟 Recognition: Amplifying Moroccan talent and showcasing our creators to the world
• 🚀 Growth: Providing the infrastructure for sustainable streaming careers

• 🔴 Real-time Discovery: Never miss when your favorite Moroccan streamers go live across Twitch and Kick
• 📱 Browser Extension: Instant access to live Moroccan streamers with desktop notifications
• 🌐 Community Web Platform: Discover new creators and connect with fellow community members
• 🎯 Streamer Spotlight: Community-powered suggestions to help talented creators gain visibility
• 🔄 Multi-Platform Unity: See all Moroccan streamers in one place, regardless of their platform
• 📊 Growth Analytics: (Coming Soon) Help streamers understand and grow their audience
• 🤝 Creator Networking: (Coming Soon) Connect Moroccan streamers for collaboration opportunities

Screenshots coming soon...

This monorepo includes the following packages/apps:

• backend: A Hono + Bun API server with real-time stream tracking
• web: An Astro web application for the community platform
• extension: A Plasmo browser extension for Chrome

• @lgamila/shared: Shared utilities and type definitions
• @lgamila/logging: Structured logging with context support and Sentry integration
• @lgamila/design-system: Shared UI components built with Radix UI and Tailwind CSS
• @lgamila/typescript-config: TypeScript configurations

• Node.js >= 18
• pnpm (recommended package manager)
• Docker (for local database, optional)
• PostgreSQL database
• Redis server

1. Clone the repository:

   git clone https://github.com/stormix/lgamila.git
   cd lgamila

2. Install dependencies:

   npm install -g pnpm
   pnpm install

3. Set up environment variables:

   Create environment files for the backend and other apps as needed. Refer to the individual app README files for specific environment variable requirements.

4. Set up the database:

   # Push database schema
   pnpm --filter backend db:push
   
   # Generate and run migrations (optional)
   pnpm --filter backend db:generate
   pnpm --filter backend db:migrate

5. Start the development servers:

   # Start all apps
   pnpm dev
   
   # Or start individual apps
   pnpm --filter backend dev    # Backend API
   pnpm --filter web dev        # Web platform
   pnpm --filter extension dev  # Browser extension

pnpm lint                  # Run linting across all packages
pnpm format               # Format code across all packages
pnpm check-types          # Type check all packages

pnpm build                # Build all packages
pnpm --filter web build   # Build only web app
pnpm --filter extension build:all  # Build extension for all browsers

The backend provides a REST API for accessing streamer data:

• GET /api/streamers - Get list of streamers with optional filtering
• GET /api/streamers/multi - Get streamers active on multiple platforms
• POST /api/streamers/suggest - Suggest a new streamer

1. Build the extension using the command from the Development Commands section
2. Load the extension in your browser:
   • Chrome: Load from apps/extension/build/chrome-mv3-prod
   • Firefox: Load from apps/extension/build/firefox-mv2-prod
3. Get instant notifications when Moroccan streamers go live and never miss your favorite creators

Visit our website at lgamila.ma to download the extension for your browser with easy installation instructions.

Visit lgamila.ma to:

• Discover talented Moroccan streamers across all platforms
• Support creators by suggesting new streamers to feature
• Connect with our growing community of streamers and viewers
• Learn about our mission to empower Moroccan creators

Since launching, LGamila has been making a tangible impact on the Moroccan streaming community:

• Growing Network: Connecting streamers and viewers across Morocco and the diaspora
• Increased Visibility: Helping talented creators gain recognition they deserve
• Cross-Platform Discovery: Unifying the fragmented streaming landscape for Moroccan content
• Community Collaboration: Fostering connections between creators for mutual growth

Want to be part of our growing community? Download the extension or suggest a streamer today!

Extension releases are automatically built and published via GitHub Actions. Each release includes:

• Chrome Extension (Manifest V3) - Compatible with Chrome, Edge, and Chromium browsers
• Firefox Extension (Manifest V2) - Compatible with Firefox

Visit lgamila.ma to download the latest extension builds with easy installation for Chrome, Firefox, and other browsers.

For maintainers, see RELEASING.md for detailed release instructions.

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Follow the existing code style and conventions
• Add tests for new features
• Update documentation as needed
• Use conventional commits format
• Ensure all checks pass before submitting PR

This project is licensed under the MIT License - see the LICENSE file for details.

Note: This project is not affiliated with Twitch, Kick, or any of their parent companies. All trademarks are the property of their respective owners.

Stormix - @stormix_dev - [email protected]

Project Link: https://github.com/stormix/lgamila

LGamila exists because of the incredible Moroccan streaming community and the open source ecosystem that powers our tools. Special recognition goes to:

• Zikoos Jam - Original inspiration and the spark that started this journey
• EKB9816 - Our talented designer who created our beautiful logo and branding
• Every Moroccan streamer featured on our platform - You make our community vibrant and inspiring
• The contributors and supporters who help us grow and improve every day

• Hono - Fast web framework
• Astro - Modern web framework
• Plasmo - Browser extension framework
• Drizzle ORM - TypeScript ORM
• Tailwind CSS - Utility-first CSS framework
• shadcn/ui - Beautiful UI components
• Turborepo - Monorepo management
• Twitch API - Twitch platform integration
• Kick API - Kick platform integration

🇲🇦 Built by streamers, for streamers
Made with ❤️ by the Moroccan Streaming Community
Empowering creators, one stream at a time

🌐 Visit Our Platform • 📱 Download Extension • 🎯 Suggest a Streamer