WebAmp

Simulation d’ampli guitare/basse : frontend React + helper audio natif (latence cible sous 10 ms).

App : app.webamp.studio · Contribuer : CONTRIBUTING.md · Sécurité : SECURITY.md · Code de conduite : CODE_OF_CONDUCT.md

Stack

Fonctionnalités

• 100+ pédales d’effets, amplis modélisés, chaîne drag & drop
• Machine à rythmes, presets Supabase, upload d’IR
• Monitoring temps réel, design neumorphic
• Helper C++ optionnel (WASAPI / ASIO / CoreAudio / PipeWire)

Architecture

WebAmp/
├── native/      # Helper C++ (ASIO/WASAPI/CoreAudio)
├── frontend/    # React / TypeScript / Vite
├── supabase/    # Migrations, Edge Functions
└── docs/        # Documentation

Démarrage rapide

Utilisateurs

1. Ouvrir app.webamp.studio
2. Pour la latence minimale : installer le Native Helper depuis les réglages

Développeurs

git clone https://github.com/Probe311/WebAmp.git
cd WebAmp/frontend
npm install
cp .env.example .env.local   # placeholders → vos clés
npm run dev                  # http://localhost:10000

Build natif (optionnel) : voir docs/GETTING_STARTED.md et native/README_PACKAGING.md.
WebSocket local par défaut : ws://localhost:8765.

Issues labellisées good first issue / help wanted : bons points d’entrée.

Sécurité

Voir SECURITY.md. Modèle d’env : frontend/.env.example.
Toute variable VITE_* est dans le bundle navigateur — jamais de secrets serveur (service_role, Gemini, Resend, OAuth client secret).

Si fuite dans l’historique : scripts/PURGE_GIT_SECRETS.md + rotation dashboard obligatoire.

Déploiement

Frontend : Vercel (push sur main). Variables obligatoires :

• VITE_SUPABASE_URL
• VITE_SUPABASE_ANON_KEY

Optionnelles (client / publiques uniquement) : VITE_WEBSOCKET_URL, VITE_ADMIN_UUID, VITE_PEXELS_API_KEY, VITE_PIXABAY_API_KEY, VITE_FREESOUND_API_KEY, VITE_FREESOUND_CLIENT_ID.

Secrets Edge (dashboard Supabase, pas VITE_*) : GEMINI_API_KEY, RESEND_API_KEY, CONTACT_EMAIL, RESEND_FROM_EMAIL, CORS_ALLOWED_ORIGINS, FREESOUND_CLIENT_SECRET.

Détails : docs/VERCEL_ENV_VARS.md, docs/DEPLOYMENT.md, supabase/README.md.

Documentation

• docs/README.md — index
• GETTING_STARTED · ARCHITECTURE · DESIGN_SYSTEM
• API WebSocket · REFERENCE_PEDALES · REFERENCE_AMPLIS

Licence

MIT — en contribuant, vous acceptez que vos contributions soient sous cette licence.