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.

Live Demo & Download

• Admin Panel: classimarket.devsnack.dev/admin
• Demo APK (Android): Download APK

Demo Credentials

The demo environment is reset periodically. Use the credentials below to log in.

• Admin: admin@classimarket.com / Admin123!
• Seller: seller@classimarket.com / Seller123!
• Buyer: buyer@classimarket.com / Buyer123!

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 throughout — bearer tokens for the Flutter app, an httpOnly cookie session 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 in chat
• Read receipts and user blocking
• Push notification on every new message

Offers & Price Negotiation

• Buyers send a price offer on any listing marked Negotiable — offers are blocked on Fixed, Free, and Contact-for-Price listings
• Sellers accept, decline, or counter — unlimited counter-offer rounds, each linked into a single negotiation chain
• Buyers can withdraw a pending offer at any time
• Offers render as interactive cards inline in the chat thread, with live status updates over Socket.io on both mobile and web
• Optional expiry per offer — an expired offer can no longer be accepted or countered
• One live offer per conversation, so a negotiation stays a single readable thread
• Push notification and in-app notification on every offer event (received, accepted, declined, countered, withdrawn)
• Seller-side offer management in the Next.js dashboard, plus a GET /api/offers endpoint to list offers sent or received

Subscriptions & Monetization

• Tiered subscription plans (Free / Basic / Premium / Enterprise)
• Per-plan listing quota and featured listing allowance
• One-time featured listing boost purchase
• Stripe payment integration
• 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 management (create, edit, reorder, nested hierarchy)
• 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 16 (App Router) — React 19, TypeScript, Tailwind CSS v4, 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 — subscription and one-time payments
• Google Maps — nearby listings and geolocation
• Google AdMob — in-app advertising
• Nodemailer — transactional email (SMTP)

⚠️ Important — Third-Party Services Notice

Please read before purchasing. This item integrates with third-party services that are not included in the purchase price and may incur additional costs based on usage. Buyers are solely responsible for creating their own accounts, obtaining API keys, and complying with each provider’s terms of service and pricing.

• AWS S3 / Cloudflare R2 — object storage for listing images (usage-based pricing)
• Google Maps Platform — maps, geocoding, and “nearby” features (requires a billing account; free tier then usage-based)
• Stripe — subscription and one-time payments (per-transaction fees)
• Firebase (FCM + Auth) — push notifications and Google Sign-In (free tier; paid beyond quota)
• Google AdMob — optional in-app ads (revenue-share with Google)
• SMTP email provider — transactional email delivery (varies by provider)

The demo environment uses test/sandbox keys for preview only. To run the item in production you must register with each provider above and supply your own API credentials.

Deployment Ready

Includes a Dockerfile and railway.toml for one-click deployment to Railway. Also compatible with Vercel (web), Render, Fly.io, or any VPS with Nginx.

Documentation

Every purchase includes two offline HTML documentation files:

• Quick Start Guide — 15-step guide to go from zero to running in under 30 minutes
• Full Documentation — environment variables, third-party services setup, deployment, customization, and more

Easy to Customize

• Change brand color in one file — all screens adapt automatically (Material 3)
• App icon: replace one PNG, run one command
• Custom fields per category: defined in the database seed (prisma/seed.ts) and rendered automatically on listing forms
• Subscription plans: fully configurable from the admin panel
• All strings, colors, and fonts centralized for easy rebranding

Support

We provide dedicated item support for all buyers.

• Email: devsnack26@gmail.com
• WhatsApp: +855 967 413 911
• Response within 1–2 business days (Monday–Friday)

If you enjoy the item, please leave a 5-star rating — it means a lot and helps other buyers find it. Thank you! ⭐

Changelog

• v1.1.0 — 2026: Added Offers & Price Negotiation — buyers make offers on negotiable listings; sellers accept, decline, or counter across unlimited rounds, with live status updates in chat on both mobile and web, offer expiry, and push notifications on every offer event. Upgraded the stack to Next.js 16, React 19, Prisma 7, and Tailwind CSS v4, and refreshed all Flutter dependencies (Google Sign-In 7, Google Mobile Ads 9, Stripe 13).
• v1.0.0 — 2025: Initial release — full feature set including Flutter app, Next.js web, admin panel, real-time chat, subscriptions, FCM push, Google Maps, AdMob, and Stripe.