Skip to content

Repository files navigation

🇦🇫 ShivehView – Visual Display for Afghan Restaurants

ShivehView is a cloud-based visual display platform designed for Afghan restaurants across the US. It turns any Smart TV into an auto-playing cultural slideshow that showcases Afghanistan's natural beauty, history, poetry, cuisine, and more.

Restaurants can also customize their feed with their own promotional content (menus, deals, events) using a dedicated dashboard.


🎯 Purpose

ShivehView enhances the customer experience by:

  • Displaying high-quality photos of Afghanistan
  • Sharing cultural facts, poetry, and food insights
  • Allowing restaurants to insert their own branded content
  • Helping diaspora businesses stay connected with Afghan heritage

🖼️ Live Demo

Try our public loop:

http://localhost:3000

💡 Features

FeatureDescription
Auto-play SlideshowFullscreen image/video slider optimized for TVs
Cultural FeedIncludes curated Afghan landscapes, historical places, quotes, and food facts
Custom Restaurant ContentEach restaurant can upload slides (logo, promotions, menus, etc.)
Admin DashboardLogin-based portal for each restaurant to manage their display
Cloud SyncedAll content served from CDN or edge cache for fast TV loading
QR Code on ScreenOptional QR for menu, social media, or contact info
Multilingual SupportFarsi, English, Pashto (planned)
Responsive for All DevicesDisplay mode works on Smart TVs, tablets, laptops
Low Bandwidth ModeFor restaurants with limited internet speeds (planned)

📦 Tech Stack

LayerTechnologyPurpose
FrontendNext.js (App Router)Website & display loop UI
StylingTailwindCSS + Framer MotionResponsive and animated UI
DatabaseSupabase PostgresUser data, restaurant profiles, slide references
StorageSupabase StorageStore images and custom content
AuthSupabase AuthLogin system for restaurant admins
CMS (internal)Admin Panel (custom built)Upload and manage curated cultural slides
HostingVercelDeployment of frontend and backend API
CDNSupabase + Vercel EdgeFast asset delivery to Smart TVs

🧑‍🍳 For Restaurants

Each restaurant gets:

  • A private URL: shivehview.com/display/{restaurant-id}
  • A dashboard to upload their content
  • Default ShivehView cultural feed
  • Optional scheduling (e.g. menu slide every 3rd image)

Example Display Flow:

  1. Afghan Mountains (default)
  2. Herat Facts (default)
  3. Restaurant Menu (custom)
  4. Rumi Quote (default)
  5. Chef Image or Offer (custom)

🛠️ System Architecture

[ Restaurant Dashboard (Next.js) ] ----> [ Supabase Auth + DB + Storage ]
|
v
[ Admin Uploads Images / Text ]
|
v
[ Supabase CDN + Edge Functions (Caching) ]
|
v
[ Restaurant TV opens shivehview.com/display/{id} ]
|
v
[ Slideshow with auto-sync content ]

🚀 Installation

  1. Clone the repository:
git clone https://github.com/SHIVEHTEAM/shivehview.git
cd shivehview
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

🔐 Admin Roles

RolePermissions
Super AdminManage curated cultural content
Restaurant AdminUpload and manage personal slides
Viewer (TV)No login; just loads slideshow via URL

🔑 Authentication System

The platform now includes a comprehensive authentication system:

User Types

  • Admin Users: Full system access, manage all restaurants and content (created through backend)
  • Restaurant Owners: Manage their own restaurant content and slides (sign up through website)

Features

  • Secure Sign-in/Sign-up: Email-based authentication with password hashing
  • Role-based Access Control: Automatic redirects based on user type
  • Protected Routes: Secure access to admin and client dashboards
  • Session Management: Cookie-based sessions with automatic expiration

Sign-up Process

  • Restaurant Owners: Can sign up directly through the website
  • Admin Users: Created through backend database management only
  • Default Role: All sign-ups are restaurant owners by default

Demo Accounts

For testing purposes:

  • Admin: admin@shivehview.com / admin123
  • Restaurant: owner@afghanpalace.com / owner123

Environment Setup

Create a .env.local file with your Supabase credentials:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_urlNEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_keySUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
  • All images and videos are stored in the slideshow-media bucket in Supabase Storage.

💰 Monetization Plan

TierPriceFeatures
Basic Plan$9.99/moDefault cultural content + 2 custom slides
Premium Plan$19.99/moUnlimited slides, scheduling, optional QR code
EnterpriseCustomFor franchises with 5+ TVs

🧩 Future Plans

  • Offline playback support (using PWA and local caching)
  • Android TV / Fire Stick app (Phase 2)
  • Background music (Afghan instrumental)
  • Scheduled slides (menu during lunch hours only)
  • Sponsorship/ads from Afghan brands or tourist services
  • Auto-translate cultural facts (Farsi ↔ English)
  • Real-time update without refresh

👥 Target Users

  • Afghan Restaurants in the US, UK, Canada
  • Afghan Grocery Stores
  • Cultural Centers or Events
  • Airport lounges with Afghan representation

🧪 Content Guidelines

  • Image resolution: 1920x1080 preferred
  • Accepted formats: JPEG, PNG (MP4 coming soon)
  • Content limit (entry): Max 10 slides, 2 custom
  • Review policy: Admin-approved for default feed

✍️ License

MIT — © 2025 ShivehView


🙌 Contributors

  • Ahmad Seyar Hasir – Founder & Product Manager
  • Coming Soon: Designers, Content Curators, Developers

📩 Contact

For partnerships, custom requests, or demo access:

📧 contact@shivehview.com 🌐 www.shivehview.com 📱 Instagram: @shivehview.tv


Built with ❤️ for Afghan restaurants worldwide

Releases

Packages

Contributors

Languages