Pulpe

Tu sais ce qu'il te reste ? Pulpe, oui.

Application de planification budgétaire personnelle pour la Suisse. Planifie ton année, maîtrise tes dépenses, mois après mois.

Web · pulpe.app · iOS · App Store · Code · GitHub

---

Table des matières

• À propos
• Plateformes
• Stack technique
• Architecture
• Démarrage rapide
• Développement
• Tests
• Documentation

À propos

Pulpe est une application de gestion de budgets personnels développée en Suisse. Contrairement aux apps de suivi classiques, Pulpe mise sur la planification : tu crées un template mensuel avec tes revenus, charges fixes et objectifs d'épargne, puis tu génères ton budget annuel en quelques minutes.

Philosophie

Principe	Description
Planification > Suivi	Anticiper plutôt que réagir
Simplicité > Exhaustivité	KISS & YAGNI, une seule devise (CHF)
Sérénité > Contrôle	Savoir ce qu'il reste à dépenser, sans prise de tête

Fonctionnalités clés

• Templates mensuels — crée une structure réutilisable (revenus, charges, épargne)
• Planification annuelle — génère 12 budgets en un clic depuis un template
• Suivi du reste à dépenser — saisie rapide des dépenses, solde visible en temps réel
• Report automatique — l'excédent ou déficit se propage de mois en mois
• Alertes dépassement — notifications à 80%, 90% et 100% du budget
• Mode démo — exploration complète du produit sans inscription

Plateformes

Plateforme	Statut	Lien
Web	Disponible	pulpe.app
iOS	Disponible	App Store
Android	Prévu	—

Stack technique

Couche	Technologies
Frontend	Angular 21, Signals, Material 21, Tailwind CSS v4
Backend	NestJS 11, Bun, Supabase (PostgreSQL + Auth + RLS)
iOS	SwiftUI, WidgetKit
Landing	Next.js, Tailwind CSS v4
Partagé	TypeScript strict, Zod 4
Orchestration	pnpm workspaces + Turborepo

Architecture

pulpe-workspace/
├── frontend/                  # App Angular
│   └── projects/webapp/src/
│       ├── app/core/         # Services (auth, API, routing)
│       ├── app/feature/      # Features lazy-loaded par domaine
│       ├── app/ui/           # Composants stateless réutilisables
│       ├── app/pattern/      # Composants stateful réutilisables
│       └── app/layout/       # Shell applicatif
├── backend-nest/              # API NestJS
│   ├── src/modules/          # Modules métier (auth, budget, transaction…)
│   ├── src/common/           # Guards, interceptors, DTOs
│   └── src/types/            # Types Supabase générés
├── ios/                       # App iOS native
│   ├── Pulpe/                # Code source SwiftUI
│   └── PulpeWidget/          # Widget iOS
├── landing/                   # Landing page Next.js
├── shared/                    # Schémas Zod & types TypeScript
└── scripts/                   # Scripts utilitaires

Démarrage rapide

# Cloner et installer
git clone https://github.com/neogenz/pulpe.git
cd pulpe-workspace
pnpm install

# Configurer le backend
cp backend-nest/.env.example backend-nest/.env
# Éditer backend-nest/.env avec vos clés Supabase

# Lancer le projet
pnpm dev

Prérequis : Node.js LTS, pnpm 10+, Bun 1.2+, Supabase (compte configuré)

Développement

# Full stack
pnpm dev                  # Tous les services

# Par package
pnpm dev:frontend         # Frontend seul
pnpm dev:backend          # Backend seul
pnpm dev:frontend-only    # Frontend + shared
pnpm dev:backend-only     # Backend + shared

# Qualité (avant chaque commit)
pnpm quality              # Type-check + lint + format
pnpm lint:fix             # Corrections automatiques

# Build
pnpm build                # Build tous les projets

Service	URL
Frontend	http://localhost:4200
Backend API	http://localhost:3000/api
Swagger	http://localhost:3000/api/docs

Tests

Type	Outil	Commande
Unitaires frontend	Vitest	cd frontend && pnpm test
Unitaires backend	Bun Test	cd backend-nest && bun test
E2E	Playwright	pnpm test:e2e

Production

pnpm build
pnpm quality && pnpm test

Documentation

Sujet	Fichier
Architecture backend	backend-nest/docs/ARCHITECTURE.md
Base de données	backend-nest/docs/DATABASE.md

Licence

MIT