Skip to content

nithinpjohn/Restaurant-POS-application

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฝ๏ธ Kans Resto - Restaurant POS System

A modern, elegant Point of Sale (POS) system built for restaurants. Streamline your operations with intuitive table management, order tracking, menu administration, and comprehensive reporting.

Live link: Login | Dashboard

Built by: Nithin | Company: Evalogical


โœจ Features

๐Ÿ“Š Dashboard

  • Real-time sales overview with key metrics
  • Quick actions for common tasks (New Order, Menu Management, Payments, Reports)
  • Popular menu items tracking
  • Sales performance summary
  • Recent orders at a glance

๐Ÿ›’ Order Management

  • Create new orders with intuitive menu selection
  • Real-time order status tracking (Preparing โ†’ Ready โ†’ Served โ†’ Completed)
  • View detailed order information
  • Multiple order tabs (Active, Ready, Completed)
  • Search and filter functionality
  • Mark orders as ready, served, or complete with instant feedback

๐Ÿ“‹ Table Management

  • Add and manage restaurant tables
  • View table status (Available/Occupied)
  • Seat guests with party size tracking
  • View active orders for each table
  • Clear tables when customers leave
  • Delete tables with confirmation dialog

๐Ÿด Menu Management

  • View all menu items organized by category
  • Add new menu items with pricing and descriptions
  • Edit existing menu items
  • Toggle item availability (available/unavailable)
  • Search menu items by name or category
  • Delete menu items with confirmation

๐Ÿ’ณ Payment Processing

  • Process payments for completed orders
  • Multiple payment method options
  • Tip calculation
  • Order total display
  • Payment confirmation workflow

๐Ÿ“ˆ Advanced Reporting

  • Sales analytics with daily, weekly, and monthly views
  • Menu item performance reports
  • Staff performance tracking
  • Customer insights and statistics
  • Visual charts and data visualization
  • Date range filtering with quick presets

๐Ÿ‘ค User Management

  • Beautiful login page with email/password authentication
  • Profile dropdown menu with user info
  • Quick access to settings and account management
  • Logout functionality

๐Ÿš€ Tech Stack

Frontend

  • Framework: Next.js 15 (App Router)
  • Styling: Tailwind CSS with custom design tokens
  • UI Components: shadcn/ui
  • Typography: Manrope font family
  • Charts: Recharts for data visualization
  • State Management: React hooks with client-side state
  • Icons: Lucide React

Backend

  • Runtime: Node.js
  • API Routes: Next.js Route Handlers
  • Data Storage: Client-side state (Ready for database integration)

Development

  • Language: TypeScript
  • Package Manager: npm
  • Build Tool: Next.js built-in

๐Ÿ“ฆ Installation

Prerequisites

  • Node.js 18+ and npm installed
  • Git installed on your machine

Steps

  1. Clone the repository

    git clone https://github.com/yourusername/kans-resto.git
    cd kans-resto
  2. Install dependencies

    npm install
  3. Run the development server

    npm run dev
  4. Open in browser

    http://localhost:3000/login
    

Build for production

npm run build
npm start

๐Ÿ’ป Usage

Getting Started

  1. Navigate to the login page at /login
  2. Enter your credentials to access the system
  3. Start managing your restaurant from the dashboard

Creating a New Order

  1. Click "New Order" from the quick actions
  2. Browse menu items by category
  3. Click items to add them to the cart
  4. Adjust quantities using +/- buttons
  5. Select a table or enter customer info
  6. Click "Place Order"

Managing Tables

  1. Go to the Tables page
  2. View all tables and their current status
  3. Click "Seat Guests" on available tables
  4. Enter guest count and server info
  5. Click "View Order" to see what's being served
  6. Click "Clear Table" when customers leave

Processing Payments

  1. Go to the Payment page
  2. Select an order
  3. Choose payment method
  4. Add tip if applicable
  5. Review total and confirm payment

Viewing Reports

  1. Navigate to the Reports section
  2. Select your date range (Today, This Week, This Month, or custom)
  3. Choose report type (Sales, Menu Items, Staff, Customers)
  4. Analyze data with interactive charts
  5. Export data if needed

๐Ÿ—๏ธ Project Structure

โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ layout.tsx              # Root layout with font setup
โ”‚   โ”œโ”€โ”€ globals.css             # Global styles and design tokens
โ”‚   โ”œโ”€โ”€ page.tsx                # Dashboard
โ”‚   โ”œโ”€โ”€ login/
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx            # Login page
โ”‚   โ”œโ”€โ”€ new-order/
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx            # New order creation
โ”‚   โ”œโ”€โ”€ orders/
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx            # Order management
โ”‚   โ”œโ”€โ”€ tables/
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx            # Table management
โ”‚   โ”œโ”€โ”€ menu/
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx            # Menu management
โ”‚   โ”œโ”€โ”€ payment/
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx            # Payment processing
โ”‚   โ””โ”€โ”€ reports/
โ”‚       โ””โ”€โ”€ page.tsx            # Analytics and reporting
โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ pos-header.tsx          # Main navigation header
โ”‚   โ”œโ”€โ”€ menu-edit-form.tsx      # Menu item form component
โ”‚   โ”œโ”€โ”€ ui/                     # shadcn/ui components
โ”‚   โ””โ”€โ”€ toaster.tsx             # Toast notifications
โ”œโ”€โ”€ public/
โ”‚   โ””โ”€โ”€ images/                 # Food and background images
โ””โ”€โ”€ styles/                     # Additional styling files

๐ŸŽจ Design Features

Color Palette

  • Primary: Dark text on light backgrounds
  • Accent: Warm cream background (#F5F3F0)
  • Success: Green for positive actions
  • Destructive: Red for delete/cancel actions
  • Blue Gradient: Used in charts for visual appeal

Typography

  • Font: Manrope (modern, clean, restaurant-friendly)
  • Responsive: Scales beautifully across all devices

UI/UX Highlights

  • Card-based layout for easy scanning
  • Status indicators with color coding
  • Loading states and feedback messages
  • Confirmation dialogs for critical actions
  • Toast notifications for user feedback
  • Mobile-responsive design

๐Ÿ”„ Workflow

Order Workflow

Create Order โ†’ Items to Cart โ†’ Select Table โ†’ Place Order โ†’ 
Preparing โ†’ Mark Ready โ†’ Served โ†’ Complete Order โ†’ Archive

Table Workflow

Available Table โ†’ Seat Guests โ†’ Occupied โ†’ View Order โ†’ 
Complete Order โ†’ Clear Table โ†’ Available

Menu Management Workflow

View Menu โ†’ Add Item โ†’ Edit Details โ†’ Set Availability โ†’ 
Monitor Performance โ†’ Delete if Needed

๐ŸŽฏ Key Pages

Page Path Purpose
Login /login User authentication
Dashboard / Overview and quick actions
New Order /new-order Create and customize orders
Orders /orders Manage all orders
Tables /tables Manage restaurant tables
Menu /menu Edit menu items and availability
Payment /payment Process payments
Reports /reports View analytics and reports

๐Ÿšฆ Status Indicators

Order Status

  • ๐ŸŸก Preparing - Order is being prepared
  • ๐ŸŸข Ready - Order ready for serving
  • ๐Ÿ”ต Served - Order served to customer
  • โšซ Completed - Order finished and paid

Table Status

  • ๐ŸŸข Available - Table is empty and ready
  • ๐Ÿ”ด Occupied - Table has customers

Menu Item Status

  • โœ… Available - Item can be ordered
  • โŒ Unavailable - Item is out of stock

๐Ÿ“ฑ Responsive Design

The application is fully responsive and optimized for:

  • ๐Ÿ“ฑ Mobile devices (320px+)
  • ๐Ÿ“ฑ Tablets (768px+)
  • ๐Ÿ’ป Desktop (1024px+)
  • ๐Ÿ–ฅ๏ธ Large screens (1280px+)

๐Ÿ”ฎ Future Enhancements

  • Database integration (Supabase/Neon)
  • Real authentication with JWT
  • Inventory management system
  • Kitchen display system (KDS)
  • Customer loyalty program
  • Staff management and scheduling
  • Multi-location support
  • Receipt printing
  • Mobile app version
  • Real-time order notifications
  • AI-powered recommendations

๐Ÿค Contributing

We welcome contributions! Please follow these steps:

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

๐Ÿ“„ License

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


๐Ÿ‘จโ€๐Ÿ’ป Author

Nithin


๐Ÿข Company

Evalogical


๐Ÿ†˜ Support

For support, email support@evalogical.com or open an issue in the repository.


๐Ÿ“ž Contact

Have questions or suggestions? Get in touch!


๐Ÿ™ Acknowledgments


Made with โค๏ธ by Nithin at Evalogical

โญ If you find this project helpful, please star it on GitHub!

About

A modern, elegant Point of Sale (POS) system built for restaurants. Streamline your operations with intuitive table management, order tracking, menu administration, and comprehensive reporting.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors