HomeProjectsChiya Nepal
Back to Projects
SaaS / Web App
Completed
Featured

Chiya Nepal

A modern full-stack café management platform powering a tea house chain across Nepal — from customer-facing web presence to real-time admin operations.

Chiya Nepal
Production Ready
20+
Admin Modules
15+
Database Models
Multi-Branch
Active Locations
Overview

About This Project

Chiya Nepal is a production-grade, full-stack web application built for a real tea house chain with multiple locations across Nepal.

The project serves two distinct audiences: Customers experience a polished, responsive public website where they can explore the café's story, browse the tea menu, view an interactive masonry gallery with lightbox modal, read dynamic testimonials, learn about the curated sound experience, and find location details with an embedded Google Map.

Staff & Administrators access a comprehensive admin dashboard for managing every aspect of café operations: products & categories, orders with real-time status pipeline (Pending → Processing → Ready → Delivered → Paid), gallery images with 8 categories, staff accounts with role assignments, customer messages with threaded conversations, Firebase push notifications for web and Android, expenses with status management, sales analytics with Recharts visualizations, FAQs with categories, social media links, table management across branches, and QR code generation for digital menus.

The platform is fully deployed on Vercel, uses PostgreSQL (Neon) for scalable data storage, Cloudinary for optimized image management with automatic format selection, Firebase Cloud Messaging for real-time alerts, and supports a mobile-first responsive design with accessibility considerations throughout.

Capacitor integration enables Android push notification support, and the PWA manifest makes it installable on devices..

Challenges

  • 1Building a real-time order status system with a multi-stage pipeline (Pending → Processing → Ready → Delivered → Paid) with per-item status updates
  • 2Implementing role-based access control (Owner / Admin / Staff) with granular permissions across 20+ admin modules, secured at both middleware and component levels
  • 3Integrating Firebase Cloud Messaging for push notifications across web and Android (Capacitor) with targetable audience delivery and device registration management
  • 4Managing multi-branch operations with individual branch-level status tracking, data isolation, and branch-aware database queries
  • 5Handling Cloudinary image management with categorized uploads across gallery (8 categories), products, and profile images with responsive transformations
  • 6Building a comprehensive sales analytics dashboard with Recharts visualizations and expense tracking with status management

Solutions

  • 1Designed a state-machine order pipeline with per-item status tracking, real-time dashboards, and visual status indicators across the admin interface
  • 2Built a custom role-based middleware layer using NextAuth.js with Prisma adapter, securing all admin routes at both middleware and component levels with role-appropriate data access
  • 3Implemented Firebase Admin SDK with device registration tokens, targetable notifications by audience (Owner/Admin/Staff), and Capacitor bridge for Android push support
  • 4Created a BranchProvider context and branch-aware database queries, enabling seamless multi-location data isolation with individual branch status tracking
  • 5Integrated Cloudinary's upload API with categorized folders, responsive image transformations, automatic format selection, and optimistic UI updates
  • 6Developed a data analysis dashboard with Recharts for sales visualization, expense tracking with status management, and exportable reports
Stack

Technology & Architecture

Next.js 15React 19TypeScriptPostgreSQL (Neon)Prisma ORMNextAuth.js v4Tailwind CSSshadcn/uiCloudinaryFirebase Cloud MessagingFirebase AdminRechartsReact Hook FormZodFramer MotionLucide ReactReact IconsCapacitorjsPDFqrcodeVercel
Design

Design & UX Highlights

Dark, warm color palette inspired by tea culture — deep browns, amber, cream, and muted greens
Custom typography using Geist (Vercel's font family) with elegant display headings
Fluid responsive design with clamp()-based typography scaling
Glassmorphism and backdrop blur effects in navigation and overlays
Animated typing effect on the hero section with reduced-motion support
Floating animation on the 'Our Story' image collage for visual depth
Sticky announcement ticker that hides/shows on scroll direction
Masonry gallery layout with lightbox modal and keyboard (Escape) dismiss
CSS-only animations with prefers-reduced-motion compliance
Back button integration with history API for mobile navigation
Smooth scroll behavior and fade-up section entries
Security

Security & Access Control

Role-based access (Owner / Admin / Staff) protects all admin routes
Next.js middleware enforces authentication on protected routes
Password hashing with bcryptjs for credential authentication
Environment-based secrets for database, auth, and third-party services
Input validation via Zod schemas on all API endpoints
SQL injection protection through Prisma's parameterized queries
Roadmap

Future Roadmap

Multi-language support (Nepali / English)
Online payment gateway integration (eSewa, Khalti)
Real-time order notifications via WebSockets
Customer loyalty program with reward tracking
Inventory management module
Enhanced analytics with exportable reports
Staff shift scheduling
iOS Capacitor support
Chiya Nepal completely transformed how we manage our café operations. The real-time order system and admin dashboard have saved us countless hours and reduced errors significantly.
C
Chiya Nepal Management
Operations Team

Chiya Nepal

SaaS / Web App

Role
Full-Stack Developer & Architect
Year
2025
Duration
Ongoing (Production)
Client
Chiya Nepal Tea House Chain

Technologies

Next.js 15React 19TypeScriptPostgreSQL (Neon)Prisma ORMNextAuth.js v4Tailwind CSSshadcn/ui+13
Explore

Other Projects

Hostiva
Completed
Featured
SaaS / Web App

Hostiva

A comprehensive multi-tenant SaaS platform providing a complete digital operations toolkit for the hospitality industry. Serves public visitors, business owners/staff, and super admins with strict data isolation between tenants.

Next.js 15React 19TypeScriptPostgreSQL (Neon)+20
30+
Database Models
8
Business Types
4
User Roles
NovaAxis CRM
Completed
Featured
CRM / Communication

NovaAxis CRM

A centralized operations hub for service-based businesses in Nepal — combining CRM with direct WhatsApp Messaging API integration, AI-powered assistance, and comprehensive client management tools in a single dashboard.

Next.js 16React 19TypeScriptPostgreSQL (Neon)+16
4+
API Integrations
10+
Dashboard Modules
2
Messaging Channels
Open to Freelance & Contract Projects

Ready to Build Something Exceptional?

Whether you need a full-stack web application, SaaS platform, booking system, or a premium portfolio site — let's architect something production-ready and deployed on Vercel or your preferred cloud.

Next.js App Router
Neon / Supabase DB
Cloudinary Media
Vercel Deployment

Usually responds within 24 hours · Based in GMT+5:45 · Available for international projects

Aaditya — Full Stack Developer & Application Architect