Cavo Store | Premium Footwear

A modern, high-performance fullstack website for the Cavo Store premium footwear destination, built with Next.js 14, TypeScript, and PostgreSQL.

🌟 Features

Public Features

• Homepage - Premium hero with dynamic broadcast alerts
• Features Page - High-impact Cavo feature showcase
• Dynamic Stats - Live Active Users and Product Count with count-up animations
• Order Center - Optimized product and Collection selection
• Gallery Gallery - Premium glassmorphism lightbox
• Staff Page - Developer profiles with role badges

Admin Dashboard

• Product Management - CRUD operations for products
• Collection Management - Version control and changelog
• Staff Management - Member profiles and roles
• Analytics Dashboard - Order statistics and insights
• Native Mobile Experience - Bottom Dock & blurred overlays
• Real Activity Logs - Live system monitoring from database
• Revalidation Engine - Instant data sync between Admin & Public
• FAQ Management - Dynamic content management
• Contact Forms - View and manage submissions
• Gallery - Gallery content management
• Social Media - Dynamic social media links
• Store Settings - Site configuration

📖 Full Feature Documentation | Dokumentasi Fitur | الميزات الكاملة

🛠️ Tech Stack

Frontend

• Next.js 14 - App Router with Server Components
• TypeScript - Type safety
• Tailwind CSS - Utility-first styling
• Framer Motion - Smooth animations
• Lucide React - Modern icons
• Radix UI - Headless UI components

Backend

• Next.js API Routes - RESTful API
• Prisma ORM - Type-safe database access
• PostgreSQL - Relational database
• Session Auth - Secure authentication

🚀 Getting Started

Prerequisites

• Node.js 18+
• PostgreSQL database
• npm or yarn

Installation

1. Clone the repository:

git clone https://instagram.com/sleep-bugy/Cavo Store-website.git
cd Cavo Store-website

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env

Edit .env with your credentials:

DATABASE_URL="postgresql://user:password@localhost:5432/projectmove"

4. Set up the database:

npx prisma generate
npx prisma db push

5. Run the development server:

npm run dev

Open http://localhost:3000 to view the site.

📁 Project Structure

Cavo Store/
├── src/
│   ├── app/              # Next.js app router pages
│   │   ├── admin/        # Admin dashboard
│   │   ├── api/          # API routes
│   │   └── ...           # Public pages
│   ├── components/       # Reusable UI components
│   ├── lib/              # Utilities and configs
│   └── types/            # TypeScript types
├── prisma/
│   └── schema.prisma     # Database schema
├── public/               # Static assets
└── schema.sql            # SQL schema with sample data

📊 Database Setup

1. Create PostgreSQL database (Neon/Supabase recommended)
2. Run the schema (includes analytics setup with indexes):

   psql -U your_user -d your_database -f schema.sql

3. Generate Prisma Client:

🗄️ Database Schema

Core Tables

• Product - Supported products
• Rom - Collection versions and clusters
• Order - Order tracking
• StaffMember - Staff profiles
• Faq - Frequently asked questions
• ContactForm - User submissions
• Screenshot - Gallery images
• SocialLink - Community links
• SiteConfig - Site settings

📡 API Endpoints

Public APIs

• GET /api/faq - Get all FAQs
• GET /api/gallery - Get gallery gallery
• GET /api/social - Get active social links
• GET /api/orders - Get Collection orders
• POST /api/contact - Submit contact form

Admin APIs

All admin APIs require authentication:

• /api/admin/products - Product CRUD
• /api/admin/collections - Collection management
• /api/admin/staff - Staff management
• /api/admin/faq - FAQ management
• /api/admin/contact - View submissions
• /api/admin/gallery - Gallery management
• /api/admin/social - Social links management

🎨 Design System

• Theme: "Deep Noir & Violet" Premium aesthetic
• Visuals: High-clarity glassmorphism & backdrop-blur
• Animations: Organic Starfield & Mesh backgrounds
• Mobile First: Native app-style Bottom Dock navigation

🔒 Admin Access

Access the admin dashboard at /admin:

• Product & Collection management
• Content management (FAQ, Gallery, Social)
• Staff member profiles
• Contact form submissions
• System settings

📱 Community

Join our community channels:

• WhatsApp Updates: https://t.me/xCavo
• Group Discussion: https://t.me/CavoDiscussion
• Cloud Storage: https://t.me/CavoCloud

🚀 Deployment

Vercel (Recommended)

1. Push code to Instagram
2. Import project in Vercel
3. Add environment variables
4. Deploy!

Environment Variables

DATABASE_URL="your-postgresql-url"
NEXT_PUBLIC_APP_URL="https://your-domain.com"

🤝 Contributing

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

📄 License

This project is licensed under the MIT License.

👨‍💻 Credits

Website Development:

• Mohammad Adi - @sleep-bugy
  • Full-stack development
  • UI/UX design implementation
  • Database architecture
  • Admin dashboard

Cavo Project:

• Cavo Store Staff

💖 Support

If you find this project helpful, consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs via Instagram Issues
• 💡 Suggesting features
• 🤝 Contributing to the code

📊 Stats

• 30+ Pages and components
• 8 Admin management interfaces
• 15+ API endpoints
• 9 Database models
• ~10,000+ Lines of code

---

Made with ❤️ by Mohammad Adi | Cavo Store Staff