> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wrappy.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Wrappy

> Redonner de l'émotion au cadeau digital.

## Le projet

Wrappy est une plateforme d'unboxing digital immersif. Elle recrée l'expérience émotionnelle du déballage d'un coffret physique — en 3D, depuis un lien — pour les marques qui vendent des cadeaux digitaux.

Le problème : un cadeau à 500€, livré par PDF. L'écart entre la valeur du cadeau et la qualité de l'expérience est insultant. Wrappy le comble.

## Architecture

<CardGroup cols={2}>
  <Card title="Landing page" icon="globe" href="https://wrappy.app">
    TanStack Start · React 19 · Tailwind CSS 4 · Three.js
  </Card>

  <Card title="API" icon="server">
    Hono.js · Drizzle ORM · Neon PostgreSQL · Pino
  </Card>

  <Card title="Design system" icon="palette">
    `@wrappy/design-system` — composants partagés et tokens de design
  </Card>

  <Card title="Infra" icon="cloud">
    VPS Hetzner · Dockploy · GitHub auto-deploy
  </Card>
</CardGroup>

## Monorepo

```
apps/
  landing/     → wrappy.app (port 3000)
  api/         → api.wrappy.app (port 4000)
  docs/        → docs.wrappy.app (port 3004)
packages/
  ui/          → composants Shadcn/Radix
  design-system/
  db/          → schémas Drizzle + migrations
  configs/     → config partagée, env schemas
  observability/ → logger Pino
```

## Commandes

```bash theme={null}
bun run dev          # Démarrer tout en parallèle
bun run build        # Compiler toutes les apps
bun run typecheck    # Vérifier les types
bun run check        # Lint Biome
bun run format       # Formatter le code
```