CUT2STYLE (C2S)

Type
Product
Built with
Python
Source
Private repository
Live at
app.cut2style.com
app.cut2style.com
CUT2STYLE (C2S) screenshot

Overview

A multi-vertical services and commerce platform combining locally delivered beauty, wellness and home services with a global storefront — customer-facing booking and shopping on one side, vendor and staff operations on the other.

Core features

The core engine is OSGS, a vendor referral marketplace: vendors apply and are approved, are listed under a category/subcategory taxonomy, and their referral traffic is tracked through product referral and tracking events into recorded conversions, which generate commissions, cashback claims and automated invoicing. Around it sit a customer wallet with admin controls, vendor payout methods, tiered memberships, subscription billing, and a full restaurant vertical (menus, orders, reservations, ratings and settlements). A browser extension authenticates via scoped tokens.

Architecture

FastAPI + SQLAlchemy over PostgreSQL with versioned API routing (/v1) split into public, auth and authenticated surfaces, plus Taskiq + Redis for async billing and settlement runs and S3-compatible object storage. The Next.js App Router frontend is partitioned by audience into route groups — public pages, auth, staff portal and a vendor area — so each role gets a distinct interface over shared data, with RBAC preventing cross-vendor visibility.

Referral attribution is modelled explicitly rather than inferred: separate entities for referral events, tracking events and conversions preserve the evidence chain from click through to the commission a vendor is ultimately invoiced for.

Frameworks, tools & libraries

The stack behind it

Frameworks

  • FastAPI
  • Next.js
  • React
  • Tailwind CSS

Tools & infrastructure

  • PostgreSQL
  • Redis
  • Taskiq
  • S3-compatible storage
  • Stripe
  • Docker

Libraries

  • SQLAlchemy
  • SynAlchemy
  • Alembic
  • TanStack Query
  • TanStack Table
  • FullCalendar
  • SynTextEditor
  • Zustand

Built on libraries I maintain

Libraries of mine that this project runs on.

Skills applied

What I brought to it

  1. 01

    Two-sided marketplace design (customers, vendors and staff)

  2. 02

    Referral attribution and tracking

    traffic → conversion → commission

  3. 03

    Automated commission calculation, invoicing and vendor billing

  4. 04

    Vendor onboarding and approval workflows

  5. 05

    Role-based access control across staff, vendor and customer audiences

  6. 06

    Multi-language / internationalised storefront

  7. 07

    E-commerce and service-booking flows in one product

  8. 08

    Browser extension development

  9. 09

    Async job processing (Taskiq + Redis), containerised deployment

Languages

What it's written in

  • Python~254 files

    FastAPI backend

  • TypeScript / TSX~411 files

    Next.js frontend

  • JavaScript~78 files

    browser extension and config

  • CSS~79 files

    styling

  • SQL

    schema and migrations

Next project

AlphaChart

A financial charting library for React and Next.js (@alphachart/react)