🍽️ Swift Food

Digital Menu for Cafes and Restaurants

Features • Tech Stack • Getting Started • Project Structure • Contributing

🤔 Why Swift Food?

• 🌍 Open Source: Completely free and open-source. No hidden costs, no premium features.
• 🔄 Actively Maintained: Everything is being updated and developed continuously.
• ⚡ Fast & Simple: Built with cutting-edge technology for maximum performance.
• 🎨 Modern Stack: Uses the latest web technologies for the best developer experience.

---

✨ Features

🎯 Core Features 📱 Digital Menu Display: Beautiful, responsive menu for cafes and restaurants 👥 Multi-Vendor Support: Multiple restaurant owners can manage their menus 🏪 Restaurant Management: Complete CRUD for restaurant profiles 📋 Category Management: Organize menu items with customizable categories 🍕 Menu Item Management: Add, edit, and manage food items with images

🔧 Technical Features 🔐 JWT Authentication: Secure login for restaurant owners and admins 🛡️ Role-Based Access: Admin, Restaurant Owner, and Customer roles 📸 Image Upload: Upload and manage images for menus and items 🎨 Custom Branding: Each restaurant can have custom colors and themes 📱 Mobile-First Design: iOS-style glassmorphism UI with responsive layout

🛠️ Refactor

• Component
• Filter
• Edit modal
• Routing
• Type share
• Auto redirect to dashboard
• Seo
• Performance

🚀 Coming Soon

• Note order
• Payment
• RTL Support
• Multi lang
• Order management system
• QR code generation for tables
• Real-time order notifications
• Analytics dashboard
• Dark mode
• PWA support
• Dockerize
• Admin Dashboard
• Multi theme
• Customer reviews and ratings

---

🛠️ Tech Stack

Frontend

Backend

Tools

---

📁 Project Structure

Swift-Food/
├── 🖥️ client/ # Frontend React Application
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ │ ├── layout/ # Header, Footer, Sidebar
│ │ │ ├── menu/ # Menu items, categories
│ │ │ ├── notebook/ # Cart/notebook functionality
│ │ │ ├── owner/ # Restaurant owner panel
│ │ │ └── ui/ # Base UI components (buttons, inputs)
│ │ ├── pages/ # Route pages
│ │ │ ├── owner/ # Owner dashboard pages
│ │ │ └── ... # Customer-facing pages
│ │ ├── services/ # API service layer
│ │ ├── store/ # Zustand state management
│ │ ├── types/ # TypeScript type definitions
│ │ └── lib/ # Utility functions
│ ├── public/ # Static assets
│ ├── vite.config.ts # Vite configuration
│ └── package.json
│
└── ⚙️ server/ # Backend Hono Application
│ ├── src/
│ │ ├── config/ # Database configuration
│ │ ├── controllers/ # Request handlers
│ │ ├── middleware/ # Auth, error handling, validation
│ │ ├── models/ # MongoDB schemas
│ │ ├── routes/ # API route definitions
│ │ ├── validators/ # Zod validation schemas
│ │ └── index.ts # Server entry point
│ ├── uploads/ # Uploaded images
│ └── package.json
│
├── 📄 turbo.json # Turborepo configuration
├── 📄 package.json # Root package.json
└── 📄 README.md # You are here!

---

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• Bun (v1.0.0 or higher)
• MongoDB (v6.0 or higher)
• Git

Installation

1. Clone the repository

   git clone https://github.com/mrrSwift/Swift-Food.git
   cd Swift-Food
   
   bun install
   
   cd server
   bun install
   
   cd client
   bun install
   
   # or use docker
   
   docker compose up -d
   

Set up environment variables

Create .env file in apps/server/:

MONGODB_URI=mongodb://localhost:27017/swift_food
JWT_SECRET=your-super-secret-jwt-key
JWT_EXPIRE=30d
PORT=3000
CORS_ORIGIN=http://localhost:5173
ZARINPAL_SANDBOX=true
FRONTEND_URL=http://localhost:5173
ZARINPAL_MERCHANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PUBLIC_KEY=pk_test_...   # for frontend

Create .env file in apps/client/:

VITE_API_URL=http://localhost:3000
VITE_STRIPE_PUBLIC_KEY=pk_test_...
VITE_PAYMENT_METHOD=stripe 
VITE_LANG=fa

Run in Dev

# Run with turbo
bun dev 

# or run Separately
bun dev:client
bun dev:server

# or run standalone
# in two console run Separately
cd server
bun dev

cd client
bun dev

1- Areas We Need Help With

+ UI/UX Improvements
+ Bug fixes
+ Documentation
+ Test coverage
+ Performance optimization
- Currently not accepting major architectural changes

📝 Development Notes

Current State

🟡 Alpha Stage: Core features working, but needs refinement

🟡 API: Stable but may have breaking changes

🟡 UI: Functional but needs polish

🔴 Testing: Not yet implemented

Known Issues

Image upload needs better error handling

Mobile responsiveness needs improvement in owner panel

No loading skeletons for data fetching

Missing form validation feedback

No offline support

📄 License

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

🌟 Acknowledgments

Bun - Incredibly fast JavaScript runtime

Hono - Lightweight web framework

Vite - Next generation frontend tooling

Tailwind CSS - Utility-first CSS framework

Radix UI - Unstyled, accessible components

MongoDB - Flexible document database

📞 Contact & Support

Issues: GitHub Issues

Discussions: GitHub Discussions

Email: amirshayan1381@yahoo.com

⭐ Star us on GitHub — it motivates us a lot! ⬆ Back to Top

Made with ❤️ by MrrSwift