ClassiMarket | Classified Marketplace Flutter App and Next.js Admin Panel

ClassiMarket is a production-ready, full-stack classified buy & sell marketplace — Android & iOS mobile app built with Flutter, a Next.js web platform with REST API, a fully-featured admin panel, and a shared type layer that keeps everything in sync out of the box.

What’s Included

• Flutter App — Native Android & iOS app (Dart / Flutter 3.x)
• Next.js Web App — Public marketplace, seller dashboard, 50+ REST API endpoints
• Admin Panel — Full management interface built into the Next.js app
• Shared Type Layer — Single source-of-truth API contract keeping web and mobile perfectly in sync
• Full Documentation — Setup guide, quick-start guide, and inline code comments

✨ Key Features

Marketplace & Listings

• Infinite scroll listing feed with pull-to-refresh
• Multi-level category hierarchy with per-category custom fields (text, number, select, boolean, date)
• Full-text search with filters: price range, condition, category, location, sort order
• Price types: Fixed, Negotiable, Free, Contact for Price
• Item condition tracking: New, Like New, Good, Fair, For Parts
• Featured / promoted listing slots
• Nearby listings map powered by Google Maps
• Up to 10 images per listing with automatic compression
• Listing view counter, share button, and report listing
• Listing lifecycle: Pending → Active → Sold / Expired / Rejected

User Authentication

• Email & password registration with email verification
• Google Sign-In and Sign in with Apple (iOS)
• Password reset via email
• JWT authentication for the Flutter app, NextAuth sessions for the web
• Role-based access: User, Seller, Admin
• Edit profile: name, avatar, bio, phone, location
• Public seller profile page with ratings

Real-Time Chat

• Real-time messaging powered by Socket.io
• Conversation list with last-message preview and unread badge
• Image sharing and price offer messages in chat
• Read receipts and user blocking
• Push notification on every new message

Subscriptions & Monetization

• Tiered subscription plans (Free / Basic / Premium / Enterprise)
• Per-plan listing quota and featured listing allowance
• One-time featured listing boost purchase
• Stripe and PayPal payment integrations
• Google AdMob banner and interstitial ads (free-plan users only)

Notifications

• Firebase Cloud Messaging (FCM) push notifications
• In-app notification center with mark-all-read and swipe-to-delete
• Transactional emails: welcome, email verification, password reset, listing approval / rejection
• Admin broadcast push to all users or targeted segments

⭐ Reviews & Bookmarks

• 1–5 star seller ratings with optional written reviews
• Average rating displayed on seller profile
• Save and manage bookmarked listings with infinite scroll

️ Admin Panel

• Dashboard with key marketplace metrics
• User management: search, view, ban / unban, change roles
• Listing approval workflow with rejection reason
• Category and custom field management (no code required)
• Subscription plan configuration
• Report moderation queue
• Payment and transaction history
• Broadcast push notifications
• CMS: Terms, Privacy, About, Blog articles
• Platform settings key-value store

Web Platform (Next.js)

• SEO-optimized listing pages with server-side rendering (SSR)
• OpenGraph meta tags for social sharing
• Auto-generated sitemap.xml and robots.txt
• Category pages with static generation (SSG)
• Seller public profile pages
• Light and dark mode support
• Fully responsive design

⚙️ Tech Stack

• Flutter 3.x — Riverpod state management, GoRouter navigation, Dio HTTP client
• Next.js 14 (App Router) — TypeScript, Tailwind CSS, shadcn/ui
• PostgreSQL + Prisma ORM — type-safe database access
• Socket.io — real-time bidirectional messaging
• Firebase Admin SDK — push notification delivery
• AWS S3 / Cloudflare R2 — image storage with Sharp compression
• Stripe + PayPal — subscription and one-time payments
• Google Maps — nearby listings and geolocation
• Google AdMob — in-app advertising
• Nodemailer — transactional email (SMTP)