Yukinu – Multi-Vendor E-commerce Platform

An open-source, multi-vendor e-commerce platform built with a modern, type-safe technology stack. It enables buyers to shop from multiple sellers in a unified marketplace.

Links

• Live Web App
• Live Dashboard
• Project Documentation
• Mobile App Releases

Key Features

• For Customers: Unified shopping cart, advanced search and filtering, wishlists, order tracking, and vendor discovery.
• For Vendors: A dedicated dashboard for product management (including variants), order processing, and staff management.
• For Administrators: A central dashboard to manage users, approve vendors, moderate content, and manage product categories.
• Type-safe: End-to-end type safety with tRPC and Zod, ensuring robust and error-resistant code.
• Modern Stack: Built with Next.js, React, and TailwindCSS, running on a Bun-powered monorepo.
• Scalable: The monorepo architecture, managed by Turborepo, allows for efficient code sharing and independent scaling of services.

Tech Stack

Apps

• Web App
  • Next.js, React.js, TailwindCSS
  • tRPC client integration
• Dashboard
  • React, React Router, TailwindCSS
  • tRPC client integration
• Mobile App
  • React Native, Expo, TailwindCSS (via Uniwind)
  • tRPC client integration

Backend & Shared Services

• API: tRPC (type-safe communication)
• ORM: Drizzle ORM + PostgreSQL
• Validation: Zod
• Email Service: Resend
• File Storage: UploadThing

Monorepo Structure

(root)
├── apps
│   ├── dashboard        # Vendor/Admin dashboard
│   ├── mobile           # Customer-facing mobile app
│   └── web              # Customer-facing web app
├── packages
│   ├── api              # tRPC API package
│   ├── auth             # Authentication utilities
│   ├── db               # Drizzle + DB models + queries
│   ├── email            # Email service (Resend)
│   ├── lib              # Shared utilities/helpers
│   ├── ui               # Shared UI components (shadcn/ui)
│   ├── uploadthing      # File upload service
│   └── validators       # Zod validators
├── tools
│   ├── github           # Github workflows/scripts
│   ├── nginx            # Deployment config
│   └── typescript       # TS base configs
├── docs                 # Developer & legal documentation
└── docker-compose.yml   # Local deployment (NGINX + Postgres + Apps)

Getting Started

Full setup instructions are available in the Development Setup Guide.

Quick Start

1. Clone the repository:

   git clone https://github.com/tiesen243/yukinu.git
   cd yukinu

2. Install dependencies:

   bun install

3. Set up environment variables:

   cp .env.example .env
   # Edit the .env file with your credentials

4. Start the database:

   bun run db:start

5. Apply the database schema:

   bun run db:push

6. Start all applications:

   bun run dev

Deployment

1. Web and Dashboard

1.1. Docker Deployment

• Clone the repository to your server or VPS.
• Build and start the web and dashboard apps with Docker Compose:

  docker compose up --build -d web dashboard

1.2. Vercel Deployment

• Connect your GitHub repository to Vercel.
• Configure environment variables in the Vercel dashboard.

2. Mobile App

Follow the official Expo guide for building and deploying the mobile app: Create a release build locally

Contributing

Contributions are welcome! Please read the CONTRIBUTING guide for details on how to get started.

License

This project is licensed under the MIT License. See the LICENSE file for details.