flutterflow/CLAUDE.md

Uitgaanskrant — werkinstructies voor Claude

Werkdirectory

Werk uitsluitend binnen deze projectdirectory (/home/bob/Projects/ff-app/uitgaanskrant-1qhvtd). Niet daarbuiten zoeken of scannen (bijvoorbeeld geen find / over het hele bestandssysteem) — scope alle bestandsoperaties tot dit project.

FlutterFlow-workflow — belangrijk

Dit project wordt gebouwd via FlutterFlow (app.flutterflow.io). De FlutterFlow-cloudomgeving is de bron van waarheid, niet deze lokale code-export.

• De gebruiker kan geen code rechtstreeks genereren of bewerken in dit repo. Alle wijzigingen aan pagina's, componenten en modellen moeten via de FlutterFlow-website gebeuren.
• De enige uitzondering is custom functions/widgets (lib/custom_code/) — en ook die voert de gebruiker in via de Custom Code-editor op de FlutterFlow-website, niet door hier rechtstreeks bestanden te bewerken.
• Gevolg: directe Edit/Write-wijzigingen aan gegenereerde bestanden (pagina's, blocks, components, models, lib/flutter_flow/* e.d.) worden bij de volgende export/sync vanuit FlutterFlow overschreven. Zulke bestanden hier aanpassen is dus niet duurzaam.
• Werkwijze: gebruik deze lokale repo om code te lezen, logica te ontwerpen en te verifiëren (bijv. met flutter analyze) — maar vertaal het eindresultaat naar concrete, stapsgewijze instructies voor wat de gebruiker in de FlutterFlow-builder (of de Custom Code-editor) moet doen. Ga er niet van uit dat een lokale bestandswijziging behouden blijft.
• Als er via de Chrome-browser (Claude in Chrome) rechtstreeks in de FlutterFlow-builder wordt gewerkt: maak na elke afgeronde taak (niet na elke losse klik/handeling) een commit binnen FlutterFlow zelf (het eigen versiebeheer, te zien bovenin de builder als "main"/"Synced"), met een duidelijke omschrijving van wat er is veranderd. Dit is geen lokale git commit.

Lokale git-repo + pull/push-workflow (sinds 2026-08-01)

De projectdirectory zelf is een schone git-repo met origin op ssh://gogs.digitalforce.tv:2222/Uitgaanskrant.com/flutterflow.git, branch master. Dit is een eigen repo van de gebruiker, los van de grotere/rommelige repo die hoger in de mappenstructuur staat (die met AndroidStudioProjects, Flutter-SDK-installaties e.d.) — commits en pushes horen hier, in de projectdirectory zelf.

Vaste workflow na elke afgeronde taak (op expliciet verzoek van de gebruiker, 2026-08-01): niet los flutterflow export-code draaien, maar het bestaande script gebruiken:

/home/bob/Projects/ff-run-fvm.sh emulator-5554 uitgaanskrant-1qhvtd -s

Dit script (interactief van aard: device-run + hot-restart-loop) moet via Bash met run_in_background: true gestart worden — anders blokkeert het op de keypress-loop. Volg de output (Monitor of Read op het outputbestand) tot minimaal "All done!" (export gelukt) en idealiter ook een succesvolle app-launch op de emulator ("Flutter run key commands" / geen build-errors), voordat je verder gaat.

Daarna automatisch (geen aparte bevestiging per keer nodig, staand akkoord van de gebruiker):

1. git add — niet blind -A: controleer git status --short eerst. Voeg alleen daadwerkelijke FlutterFlow/app-wijzigingen toe (lib/, android/, ios/, pubspec, .gitignore e.d.). Sluit .claude/ uit (staat in .gitignore) — dat is sessiestate van Claude Code, geen app-code.
2. git commit met een duidelijke boodschap.
3. git push -u origin master (of gewoon git push zodra tracking staat).

Let op — belangrijke valkuil: flutterflow export-code overschrijft .gitignore telkens terug naar FlutterFlow's eigen standaardversie (bevestigd 2026-08-01) — een eigen toevoeging zoals de .claude/-regel hieronder verdwijnt dus bij elke pull en moet opnieuw toegevoegd worden vóór je commit. (CLAUDE.md zelf wordt door de export NIET verwijderd — dat gebeurde één keer doordat de gebruiker zelf de hele projectmap had verwijderd en opnieuw had gepulled, niet door de export-tool zelf. Maar check voor de zekerheid na elke pull toch even of dit bestand nog bestaat; zo niet, opnieuw aanmaken met deze inhoud.)

Voeg dus na elke pull, vóór je staged, deze regel weer toe aan .gitignore als hij ontbreekt:

# Claude Code session state (not app code)
.claude/