Work in progress — please read
This project may need some fixes and UI refinement because of recent changes. You can still use and set up this code now—we will polish it when we work on this project again.
Bike Auction Hub
Free
Online auction platform for bikes and more—live bidding, wallet payments, admin review, store handover, and settlement. User and admin portals in one Next.js + MongoDB app. Free source on GitHub.
Opens your link in a new tab (for example a GitHub repository).
Media
How-to & feature videos
Click a thumbnail to watch full screen.
Details
Features
- User portal — sign up / sign in, create auction requests, start approved auctions, bid on live listings, wallet recharge, Won tab payments
- Admin portal — review queue (accept/reject), platform fees, winner bank accounts, stores & categories, settlement (credit seller, final confirm)
- Auction lifecycle — pending_review → approved → live → completed (with expired/stopped states)
- Wallet bidding — deposit + purchaser fee on first bid; seller and purchaser fees locked at completion
- Multi-item support — motorcycles, scooters, spare parts, gear, and custom categories
- Handover stores — seller picks pickup location; winner confirms item received
- Seed data — demo users, live auction #3, completed auction #4, Lahore city matching for bids
- Stack — Next.js 14, React, MongoDB/Mongoose, Tailwind CSS
Compatibility
System requirements
Get the source (GitHub):
- Use the Download button on this page or visit github.com/moeezshakir/BikeAuctionHub to clone the repository.
- Then:
```bash
npm install
npm run db:seed
npm run dev
```
Environment (.env.local): Copy .env.example to .env.local and set MONGODB_URI (your MongoDB connection string—local or Atlas).
Demo logins (after npm run db:seed): password 12345678 for all accounts
| Role | Email | Login path |
|------|-------|------------|
| Admin | admin@example.com | /admin/admin-signin |
| User A (seller) | demo.user@bikeauction.com | /signin |
| User B (seller) | sara.demo@example.com | /signin |
| Bidder | john.demo@example.com | /signin |
Requirements: Node.js 18+, MongoDB (local or Atlas), modern browser for development.
Overview
Full description
Bike Auction Hub is an online auction platform for motorcycles, scooters, spare parts, gear, and more. Users list items, bid in live timed auctions, pay through admin bank accounts, and settle via wallet credits. Admins review requests, manage stores, set fees, and close settlements.
The platform includes user and admin portals. Users sign up, submit auction requests with photos and CNIC, start approved auctions, bid on live listings in their city, recharge wallets, and complete winner payments on the Won tab. Admins approve or reject pending requests, configure seller and purchaser fees, manage pickup stores and categories, add winner bank accounts, credit seller wallets, and finalize settlements.
Built with Next.js 14 (App Router), MongoDB (Mongoose), and API routes under app/api/*. A seed script creates demo admin, users, stores, categories, and sample auctions (#1–#4) so you can walk through the full lifecycle locally.
After cloning from GitHub, copy .env.example to .env.local, set MONGODB_URI, run npm run db:seed, then npm run dev. Demo password for all seeded accounts: 12345678.
More
Related products
Same category as this listing.
CVMaker
Build a polished CV in the browser: live preview, multiple templates, editable sections, autosave to your device, and export to PDF or DOCX. Great for job seekers who want control without a subscription.
ThreadDesk
Digital tailor platform—customer, seller, admin, and delivery portals. Measurements, orders, rack room, assignments, and notifications in one Next.js + MongoDB app. Free source on GitHub.