|
|
@@ -0,0 +1,81 @@
|
|
|
+# 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` doet een
|
|
|
+soort schone sync van de doelmap en **verwijdert lokale bestanden die
|
|
|
+geen deel zijn van de FlutterFlow-projectstructuur**, zoals dit
|
|
|
+CLAUDE.md-bestand zelf (dit is op 2026-08-01 daadwerkelijk gebeurd).
|
|
|
+Check dus na elke pull of dit bestand nog bestaat; zo niet, opnieuw
|
|
|
+aanmaken met deze inhoud en toevoegen aan de eerstvolgende commit,
|
|
|
+zodat het in de git-historie staat en makkelijk te herstellen is.
|
