https://github.com/callmedeci/cafe-ctrl
https://github.com/callmedeci/cafe-ctrl
eslint nextjs nuqs prettier react react-query shadcn supabase tailwindcss typescript vitest
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/callmedeci/cafe-ctrl
- Owner: callmedeci
- License: mit
- Created: 2025-08-24T10:42:56.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-10-15T20:22:24.000Z (9 months ago)
- Last Synced: 2025-10-23T19:54:42.451Z (9 months ago)
- Topics: eslint, nextjs, nuqs, prettier, react, react-query, shadcn, supabase, tailwindcss, typescript, vitest
- Language: TypeScript
- Homepage: https://cafe-ctrl.vercel.app
- Size: 4.67 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cafe-Ctrl: Smart Cafe Management System
Cafe-Ctrl is a modern, full-featured cafe management system designed to streamline daily operations, enhance customer service, and provide valuable business insights. Built with Next.js 14 and utilizing modern web technologies, it offers a comprehensive solution for cafes of all sizes.
## 🌟 Features
### 📋 Order Management
- Real-time order tracking and processing
- Support for dine-in and takeaway orders
- Customizable order details and notes
- PDF generation for order receipts
- Quick order status updates
### 🍽️ Menu Management
- Easy menu item creation and updates
- Category organization
- Price management
- Image upload support
- Ingredient tracking
- AI-powered menu description generation
### 📊 Analytics & Reporting
- Sales tracking and trends
- Popular items analysis
- Revenue insights
- Period-based performance metrics
- Customizable date ranges
### 💰 Financial Management
- Additional charges management
- Service fees and tax handling
- Payment tracking
- Revenue calculations
### ⚙️ System Features
- Multi-language support (English/Persian)
- RTL/LTR layout support
- Multiple theme options
- Responsive design
- Dark/Light mode
- Custom theme support
## 🛠️ Technologies
- **Framework**: Next.js 15 (App Router)
- **Language**: TypeScript
- **Styling**: Tailwind CSS
- **State Management**: React Query
- **Database**: Supabase
- **Authentication**: Supabase Auth
- **UI Components**: Shadcn UI
- **Form Handling**: React Hook Form
- **PDF Generation**: React-PDF
- **Internationalization**: Next-Intl
- **Icons**: Lucide Icons
## Getting Started
### Prerequisites
- Node.js 18.17 or later
- npm
- Supabase account
### Installation
1. Clone the repository:
```bash
git clone https://github.com/callmedeci/cafe-ctrl.git
cd cafe-ctrl
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables:
```bash
cp .env.example .env.local
```
4. Update the .env.local with your Supabase credentials:
```env
NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
```
5. Start the development server:
```bash
npm run dev
```
## 🎨 Available Themes
- Light/Dark Mode
- System Theme
- Pastel Dream
- Lavender Mist
- Peach Grove
- Sage Whisper
- Midnight Slate
- Mocha Dream
## 🌐 Supported Languages
- English (en)
- Persian/Farsi (fa)
## 📱 Responsive Design
Cafe-Ctrl is designed to work seamlessly across all devices:
- Desktop computers
- Tablets
- Mobile phones
## 🔒 Security Features
- Secure authentication
- Secure API endpoints
- Protected routes
## 🔄 Continuous Updates
The system is regularly updated with:
- New features
- Security patches
- Performance improvements
- UI/UX enhancements
## 🌟 Key Benefits
- **Efficiency**: Streamline cafe operations and reduce manual work
- **Insights**: Make data-driven decisions with comprehensive analytics
- **Customization**: Adapt the system to your cafe's specific needs
- **Scalability**: Grow your business with a solution that scales with you
- **User-Friendly**: Intuitive interface for both staff and managers
- **Multi-Language**: Serve diverse customers with bilingual support
- **Modern Design**: Professional and clean interface across all devices
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📞 Support
For support:
- Create an issue in the GitHub repository
---
Built with ❤️ for cafe owners and managers
Copyright © 2025 Yunes Maghsoudie