Golyx

L'app tout-en-un des coachs sportifs
CRM, planification, suivi client et rapports premium

Fonctionnalités • Pour les coachs • Pour les clients • Stack • Déploiement

---

🏋️ Présentation

Golyx est une plateforme CRM tout-en-un conçue pour les coachs sportifs et personal trainers indépendants. Elle permet de gérer vos clients, planifier des séances, suivre les progrès, envoyer des rapports premium et développer votre activité — le tout depuis une seule application.

⚡ Propulsée par TanStack Start (SSR) et déployée sur Cloudflare Workers pour des performances maximales et une disponibilité mondiale.

✨ Fonctionnalités

📊 Pour les coachs

Fonctionnalité	Description
Dashboard	Vue d'ensemble de votre activité : clients actifs, séances à venir, revenus
Gestion des clients	Profils clients avec historique complet, objectifs et notes
Planification	Calendrier interactif pour les séances et rendez-vous
Programmes	Création de programmes d'entraînement personnalisés
Suivi des progrès	Graphiques et métriques pour suivre l'évolution des clients
Rapports PDF	Génération de rapports premium avec graphiques et tableaux (jspdf)
Messagerie	Communication intégrée avec les clients
Paiements	Gestion des abonnements (89,99 MAD/mois)

👥 Pour les clients

Fonctionnalité	Description
Profil	Espace client dédié avec informations personnelles
Séances	Consultation et réservation des séances
Programme	Visualisation du programme d'entraînement
Progrès	Suivi des performances et des objectifs
Messages	Communication directe avec le coach
Mode hors-ligne	Accès aux données même sans connexion (IndexedDB)

🔧 Administration

• Validation des coachs — Système d'approbation des inscriptions avec téléchargement de documents
• Modération — Gestion des demandes d'upgrade et des comptes
• Supervision — Vue globale de l'activité de la plateforme

🛠️ Stack Technique

Technologie	Usage
React 19	UI — Dernière version avec les hooks les plus récents
TypeScript 5.8	Typage statique strict
TanStack Start	Framework SSR full-stack — Routage, server functions, middleware
Vite 7	Bundler nouvelle génération
Tailwind CSS 4	Design system utilitaire nouvelle version
shadcn/ui	Composants d'interface premium
Supabase	Backend — Auth, base de données PostgreSQL, stockage
Cloudflare Workers	Hébergement Edge — Performances mondiales
Nitro	Moteur serveur — Déploiement Cloudflare natif
jspdf + autotable	Génération de rapports PDF avec tableaux
TanStack Query	Gestion d'état serveur et cache
IndexedDB (idb)	Stockage hors-ligne — Données client en cache
Vite PWA	Service Worker — Installation sur mobile
Workbox	Stratégies de cache avancées
Zod	Validation de schémas côté client et serveur
Sonner	Notifications toast élégantes

🚀 Déploiement

L'application utilise TanStack Start avec Nitro pour le rendu serveur (SSR), déployée sur Cloudflare Workers.

# Build de production
npm run build

# Aperçu local
npm run preview

# Déploiement Cloudflare (depuis le dashboard)
# Connecter le repo → Build command: npm run build → Publish: dist

📦 Variables d'environnement

Variable	Description
SUPABASE_URL	URL du projet Supabase
SUPABASE_PUBLISHABLE_KEY	Clé publique Supabase (anon)
SUPABASE_SERVICE_ROLE_KEY	Clé service Supabase (admin)
VITE_SUPABASE_URL	URL pour le frontend
VITE_SUPABASE_PUBLISHABLE_KEY	Clé publique pour le frontend
VITE_SUPABASE_PROJECT_ID	ID du projet Supabase

💻 Développement

# Cloner le projet
git clone https://github.com/idhem85/golyx.git
cd golyx

# Copier le fichier d'environnement
cp .env.example .env

# Installer les dépendances
npm install

# Lancer le serveur de développement
npm run dev

# Build de production
npm run build

Structure du projet

src/
├── routes/                # Routes TanStack (file-based routing)
│   ├── index.tsx          # Landing page
│   ├── auth.tsx           # Authentification
│   ├── dashboard.tsx      # Dashboard coach
│   ├── dashboard.clients.tsx   # Gestion clients
│   ├── dashboard.reports.tsx   # Rapports
│   ├── client.tsx         # Espace client
│   ├── client.appointments.tsx # Rendez-vous client
│   ├── client.program.tsx      # Programme client
│   ├── client.progress.tsx     # Progrès client
│   ├── admin.tsx          # Administration
│   └── admin.*.tsx        # Pages admin
├── components/            # Composants UI réutilisables
├── hooks/                 # Hooks personnalisés
├── lib/                   # Fonctions serveur et utilitaires
├── integrations/          # Intégrations (Supabase)
└── assets/                # Images et ressources

📄 Licence

Projet privé — Tous droits réservés.

---

idhem85 • Golyx — L'app tout-en-un des coachs sportifs