How laugem/stikling works
Stikling is an offline-first houseplant tracker. The main workflow is to record plants and propagations, add care and photo history, and review what needs attention; data lives on-device unless the user signs in to sync across devices. The graph also shows the documented backup/export and account-sync branches. Some feature and API links rely on README descriptions or source-index references because their implementation excerpts were not provided.
Main entry points: Stikling.Web/Program.cs Blazor app · Stikling.Api/Program.cs Minimal API · BackupService.cs Backup and export · SyncRunner.cs Sync runner
Components 22
Web app
- Blazor app
src/Stikling.Web/Program.cs
Plant domain
- Plant records
src/Stikling.Core/Plants/PlantService.cs - Propagation batches
src/Stikling.Core/Propagations/PropagationService.cs - Photo history
src/Stikling.Core/Timeline/TimelineService.cs - Care and pests
src/Stikling.Core/Care/CareService.cs - Today tasks
src/Stikling.Core/Today - Rooms and supplies
src/Stikling.Core/Rooms/RoomService.cs - Plant names
src/Stikling.Core/Names/PlantNameService.cs
Local data
- IndexedDB
src/Stikling.Web/Services/IndexedDbRepositories.cs - Photo handling
src/Stikling.Web/Services/PhotoService.cs - Backup and export
src/Stikling.Web/Services/BackupService.cs
Accounts and sync
- Account service
src/Stikling.Web/Services/AccountService.cs - Sync runner
src/Stikling.Web/Services/SyncRunner.cs - API client
src/Stikling.Web/Services/StiklingApi.cs
Sync API
- Minimal API
src/Stikling.Api/Program.cs - Clerk sign-in
src/Stikling.Api/Auth/ClerkAuthentication.cs - Collection access
src/Stikling.Api/People/CurrentPerson.cs - Record sync
src/Stikling.Api/Sync/RecordEndpoints.cs - Account export
src/Stikling.Api/People/ExportEndpoints.cs - SQL database
src/Stikling.Api/Data/StiklingDbContext.cs - Photo blob storage
src/Stikling.Api/Photos/PhotoStorage.cs
Other components
- Plant keeper
Connections 27
- Plant keeper → Blazor app: uses
- Blazor app → Plant records: records plants
src/Stikling.Web/Program.cs - Blazor app → Propagation batches: tracks batches
src/Stikling.Web/Program.cs - Blazor app → Care and pests: logs care
src/Stikling.Web/Program.cs - Blazor app → Today tasks: reviews tasks
src/Stikling.Web/Program.cs - Blazor app → Rooms and supplies: organizes places
src/Stikling.Web/Program.cs - Blazor app → Plant names: suggests names
src/Stikling.Web/Program.cs - Plant records → Photo history: records changes
src/Stikling.Core/Plants/PlantService.cs - Propagation batches → Photo history: records history
src/Stikling.Core/Propagations/PropagationService.cs - Blazor app → IndexedDB: stores offline
src/Stikling.Web/Program.cs - Blazor app → Photo handling: handles photos
src/Stikling.Web/Program.cs - Plant keeper → Backup and export: exports data
- Backup and export → IndexedDB: reads records
src/Stikling.Web/Services/BackupService.cs - Backup and export → Photo handling: reads images
src/Stikling.Web/Services/BackupService.cs - Plant keeper → Account service: signs in
- Account service → Sync runner: starts sync
- Sync runner → IndexedDB: syncs local data
- Sync runner → API client: sends requests
- API client → Minimal API: calls API
- Minimal API → Clerk sign-in: authenticates
- Minimal API → Collection access: resolves collection
src/Stikling.Api/Program.cs - Minimal API → Record sync: routes records
- Minimal API → Account export: routes exports
src/Stikling.Api/Program.cs - Minimal API → SQL database: uses database
src/Stikling.Api/Program.cs - Minimal API → Photo blob storage: uses photo storage
src/Stikling.Api/Program.cs - Account export → Photo blob storage: reads photos
src/Stikling.Api/People/ExportEndpoints.cs - Account export → SQL database: reads account data
src/Stikling.Api/People/ExportEndpoints.cs