À propos du projet

Budget App est une application web open source pensée pour simplifier la gestion de ses finances personnelles. L'objectif : une interface claire, rapide, sans abonnement et sans cession de données à des tiers.

Fonctionnalités principales

• Suivi des dépenses et revenus — ajout rapide de transactions avec catégorie, montant et note
• Tableaux de bord mensuels — visualisation claire de l'évolution du solde
• Catégories personnalisables — créez vos propres catégories avec icônes et couleurs
• Exportation CSV — exportez vos données à tout moment
• Mode hors-ligne — les données sont synchronisées dès le retour de la connexion
• 100% open source — code disponible, contributions bienvenues

Captures d'écran

1 / 9

Page d'accueil

Stack technique

Installation

# Cloner le repo
git clone https://github.com/stefanspeter/budget-app.git
cd budget-app
 
# Installer les dépendances
npm install
 
# Configurer les variables d'environnement
cp .env.example .env.local
# Renseignez NEXT_PUBLIC_SUPABASE_URL et NEXT_PUBLIC_SUPABASE_ANON_KEY
 
# Lancer en développement
npm run dev

Architecture

Le projet suit une architecture Feature-based : chaque fonctionnalité (transactions, catégories, stats) est isolée dans son propre dossier avec ses composants, hooks et types. Cela rend le code facile à maintenir et à contribuer.

src/
  features/
    transactions/
    categories/
    dashboard/
  components/   # composants partagés
  lib/          # utilitaires et config Supabase

Contribuer

Les contributions sont les bienvenues. Consultez le fichier CONTRIBUTING.md pour les guidelines. Les issues et PRs sont ouvertes sur GitHub.