https://github.com/mysagra/mysagra
Smart ordering for your festival. Open-source fair-code solution for managing and organizing community festivals.
https://github.com/mysagra/mysagra
api-rest express mysagra mysql nextjs nextjs15 nodejs shadcn-ui tailwindcss turborepo typescript webapp webapplication
Last synced: about 1 month ago
JSON representation
Smart ordering for your festival. Open-source fair-code solution for managing and organizing community festivals.
- Host: GitHub
- URL: https://github.com/mysagra/mysagra
- Owner: MySagra
- License: apache-2.0
- Created: 2025-09-03T21:25:51.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-03T21:57:26.000Z (10 months ago)
- Last Synced: 2025-09-03T23:27:37.010Z (10 months ago)
- Topics: api-rest, express, mysagra, mysql, nextjs, nextjs15, nodejs, shadcn-ui, tailwindcss, turborepo, typescript, webapp, webapplication
- Language: TypeScript
- Homepage:
- Size: 447 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MySagra – Smart Ordering for Festivals, Fairs, and Local Events
#### **MySagra: The Open-Source Smart Ordering System for Festivals and Community Events**
MySagra is a free and open-source platform designed to revolutionize how you manage orders at your local **festival**, "sagra," food vendor stand, or **community event**. Built with flexibility and transparency in mind, it provides everything you need to switch from outdated paper processes to a modern, efficient, and reliable digital system.
#### **Why Choose MySagra?**
We focus on delivering key features essential for event organizers and food vendors, ensuring maximum efficiency and data control:
1. **Smart Order Management:** Implement a complete system for collecting orders directly from tables and at the counter.
2. **Automated Kitchen & Bar Printing:** Orders are automatically split and printed by workstation (kitchen, bar, etc.) to streamline production and reduce errors.
3. **Real-Time Performance Dashboard:** Monitor live data on sales, active orders, and overall performance in real time to make immediate, informed decisions.
4. **Offline-Friendly PWA:** Reliability is crucial. MySagra works seamlessly even without a stable internet connection, making it perfect for outdoor or temporary venues.
5. **Customizable Menu & Variants:** Easily configure your full menu, including dish variants, allergens, and dynamic pricing.
6. **Truly Open Source:** MySagra is released under the Apache-2.0 license. You own your data, have full access to the source code, and are free from vendor lock-in.
👉 Learn more at [mysagra.com](https://mysagra.com)
## Quick Start
Deploy with [Docker Compose](https://docs.docker.com/compose/):
1. Setup the `env` file following the `.env.example` file
2. Build and start the containers
```bash
docker-compose up -d
```
## Development
This project uses [pnpm](https://pnpm.io/) as package manager and [TurboRepo](https://turbo.build/repo) as monorepo tool.
1. Clone the repository
2. Make sure [pnpm](https://pnpm.io/) is installed globally
```bash
npm install -g pnpm
```
3. Then install the dependencies
```bash
pnpm install
```
4. Create the `.env` file, for the setup follow the `.env.template` in `apps/backend` and `apps/frontend` folders.
5. Run the database migrations in the `apps/backend` folder
```bash
pnpm prisma migrate dev
```
6. **[Optional] Seed the database with test data:**
There are two seed commands available in the `@packages/database` package:
- **Complete Test Seed** – Populates the database with all resources (categories, foods, ingredients, users, printers, cash registers, banners, etc.) and generates 500 orders distributed across a 4-hour time window (2 hours before to 2 hours after execution):
```bash
cd packages/database
pnpm db:seed:test
```
- **Orders-Only Seed** – Generates 500 orders using existing foods in the database. Useful if you already have your menu and infrastructure set up:
```bash
cd packages/database
pnpm db:seed:orders
```
Both commands automatically continue from the last generated display code in the database, ensuring no duplicates.
7. Start the development server with the command
```bash
pnpm run dev
```