Your Reselling Empire, Tracked in Real Time.
An open-source SaaS platform designed specifically for sneaker, streetwear, and collectibles resellers to manage their inventory, track market prices, and analyze their business using AI. Built for the Open Source Hackathon by Elite Coders.
⭐ If you find FlipTrack useful or are participating in the hackathon, please consider giving this repository a star! It helps our open-source community grow. ⭐
- Vision
- Key Features
- Tech Stack Architecture
- Getting Started
- Demo Credentials
- Project Structure
- Contributing
- License
The reselling market is booming, but resellers often rely on messy spreadsheets and fragmented tools to manage thousands of dollars in inventory. FlipTrack unifies the entire workflow into a single, cohesive dashboard. It is a feature-complete, modern alternative to existing premium trackers, fully open-sourced for the community.
Whether you are flipping 10 pairs a month or running a massive consignment operation, FlipTrack scales with your business logic.
- 📦 Comprehensive Inventory Management
Track every item with granular details including SKU, size, condition, purchase price, purchase date, and real-time status (
IN_STOCK,LISTED,SOLD). - 📈 Market Price Intelligence Automated background scraping (via API cron jobs) of real-time market prices across secondary platforms to keep your portfolio valuation accurate.
- 🧠 Generative AI Insights Powered by the Vercel AI SDK and Groq (Llama 3), FlipTrack analyzes your inventory and provides actionable, data-driven advice on when to hold and when to sell.
- 💰 Sales & Expense Tracking Log sales, track platform/shipping fees, and generate detailed P&L (Profit & Loss) statements instantly.
- 🔒 Enterprise-Grade Authentication Secure login flows utilizing Supabase Auth with strict Server-Side Rendering (SSR) cookie validation.
- ✨ Premium Glassmorphic UI A sleek, responsive, and blazing-fast interface built entirely from scratch utilizing raw CSS variables and CSS Modules, guaranteeing zero bloat from heavy UI frameworks.
FlipTrack is engineered with a modern, scalable, and fully type-safe stack:
| Layer | Technology | Purpose |
|---|---|---|
| Framework | React Router v7 | Full-stack routing, SSR, and Data Loaders |
| Language | TypeScript | Strict end-to-end type safety |
| Database | PostgreSQL (Supabase) | Robust, relational data storage |
| ORM | Prisma Client v5 | Type-safe database queries and schema management |
| Auth | Supabase Auth | Secure, cookie-based session management |
| AI Integration | Vercel AI SDK + Groq API | Lightning-fast LLM generation for business insights |
| Styling | Vanilla CSS Modules | Scoped, collision-free CSS with a robust custom variable theme system |
Follow these steps to set up the FlipTrack development environment locally.
Ensure you have the following installed and configured on your machine:
- Node.js (v18.x or higher)
- Git
- A Supabase account (for Postgres DB and Auth)
- A Groq API key (for AI features)
-
Clone the repository
git clone https://github.com/rushikesh-bobade/FlipTrack.git cd FlipTrack -
Install NPM dependencies
npm install
-
Configure Environment Variables Create a
.envfile in the root directory based on.env.example(if provided), and populate it:# Supabase Configuration NEXT_PUBLIC_SUPABASE_URL="your_supabase_project_url" NEXT_PUBLIC_SUPABASE_ANON_KEY="your_supabase_anon_key" DATABASE_URL="your_supabase_transaction_pooler_url" DIRECT_URL="your_supabase_session_url" # Groq AI GROQ_API_KEY="your_groq_api_key"
Sync your Prisma schema with your Supabase Postgres instance and generate the Prisma Client:
npx prisma db push
npx prisma generateStart the Vite development server:
npm run devThe application will be running locally at http://localhost:5173.
Want to test FlipTrack's UI and features without manually creating data? We have included an automated seed script that provisions a test user and sample sneaker inventory.
- Ensure your development server is running (
npm run dev). - Execute the demo creation script:
npx tsx scripts/create-demo-user.ts
- Navigate to
http://localhost:5173/auth/login. - Click the "Use Demo Credentials" button on the login form to instantly authenticate and view the populated dashboard.
FlipTrack relies on a highly decoupled but tightly integrated modern tech stack. Below is a high-level overview of how the systems communicate:
graph TD
%% User and UI Layer
Client([User Browser])
UI["React Router v7 UI<br/>(Components & CSS Modules)"]
%% API and Routing Layer
Loaders["Route Loaders & Actions<br/>(SSR Data Fetching)"]
%% Backend/DB Layer
Prisma["Prisma Client v5"]
Postgres[(Supabase PostgreSQL)]
Auth{Supabase Auth}
%% External Services
Groq["Groq API<br/>(Llama 3)"]
VercelAI["Vercel AI SDK"]
Cron["Cron Jobs<br/>(Market Scrapers)"]
%% Connections
Client -->|Interacts with| UI
UI -->|Server-Side Requests| Loaders
Loaders -->|Type-safe Queries| Prisma
Prisma <--> Postgres
Loaders -->|Validates Session| Auth
Loaders -->|Generates AI Insights| VercelAI
VercelAI <-->|API Calls| Groq
Cron -->|Background Price Updates| Prisma
%% Styling
classDef ui fill:#4a90e2,stroke:#fff,stroke-width:2px,color:#fff;
classDef server fill:#f5a623,stroke:#fff,stroke-width:2px,color:#fff;
classDef db fill:#3ECF8E,stroke:#fff,stroke-width:2px,color:#fff;
classDef ext fill:#8b572a,stroke:#fff,stroke-width:2px,color:#fff;
class UI ui;
class Loaders server;
class Prisma,Postgres,Auth db;
class Groq,VercelAI,Cron ext;
FlipTrack is an open-source project and we welcome contributions from the community!
Please read our Contributing Guidelines and our Code of Conduct before submitting Pull Requests.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'feat: Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.