link,[object Object]
Skip to content

Getting Started ​

Prerequisites ​

  • Node.js: v18+ (recommended: v20+)
  • Package Manager: pnpm (recommended) or npm
  • Git: For version control
  • VS Code: Recommended IDE with extensions

Quick Start ​

1. Clone and Install ​

bash
git clone <repository-url>
cd acqmarketplace
pnpm install

2. Environment Setup ​

bash
# Copy environment template
cp .env.example .env

# Configure required variables (see Environment Variables section)
# VITE_SUPABASE_URL=your_supabase_url
# VITE_SUPABASE_ANON_KEY=your_anon_key

3. Start Development ​

bash
pnpm dev

Application runs at: http://localhost:8080

Development Scripts ​

bash
# Development
pnpm dev                 # Start dev server
pnpm build              # Production build
pnpm build:dev          # Development build
pnpm preview            # Preview production build

# Database
pnpm supabase:link      # Link to Supabase project
pnpm supabase:migrations # List migrations
pnpm supabase:functions # List edge functions

# Quality
pnpm lint               # ESLint check
pnpm type-check         # TypeScript check

Project Structure ​

src/
├── components/         # Reusable UI components
│   ├── ui/            # shadcn/ui base components
│   ├── layout/        # Layout components
│   ├── forms/         # Form components
│   └── routing/       # Route definitions
├── pages/             # Page components
├── hooks/             # Custom React hooks
├── contexts/          # React Context providers
├── lib/               # Utilities and configurations
├── integrations/      # External service integrations
└── types/             # TypeScript definitions

Key Technologies ​

  • Frontend: React 18 + TypeScript + Vite
  • Styling: Tailwind CSS + shadcn/ui
  • State: TanStack Query + React Context
  • Backend: Supabase (PostgreSQL + Edge Functions)
  • Payments: Stripe integration

Next Steps: