<!--
Source: https://swappr.fr
Canonical: https://swappr.fr/llm/architecture.md
Last-updated: 2026-07-09
-->

# Swappr — Architecture publique

**TL;DR** : Swappr est une application Next.js App Router hébergée sur Vercel, avec Supabase pour la base et le stockage, Clerk pour l'auth, Kie.ai et ElevenLabs pour les générations IA, Shopify et USDC on-chain pour les paiements.

## Stack

| Couche | Technologie |
|---|---|
| Frontend | Next.js App Router, React, TypeScript, Tailwind |
| Auth | Clerk |
| Base et storage | Supabase PostgreSQL + Storage + RLS |
| Génération image/vidéo | Kie.ai |
| Audio | ElevenLabs direct |
| Paiement carte | Shopify checkout |
| Paiement crypto | USDC/USDT Ethereum et Solana |
| Observabilité | PostHog, logs applicatifs, health checks |

## Principes

- RLS Supabase sur les données utilisateur.
- Jobs asynchrones avec polling et webhooks provider.
- Crédits internes débités au lancement et remboursés selon politique provider.
- Routes marketing publiques hors Clerk pour SEO et crawlers IA.
- /llms.txt, /llms-full.txt et /llm/*.md exposent une couche markdown GEO.
