# laugem/stikling architecture

> Architecture diagram of the GitHub repository laugem/stikling, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/laugem/stikling
- Repository: https://github.com/laugem/stikling

## Overview

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: [`src/Stikling.Web/Program.cs`](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Program.cs) (Blazor app), [`src/Stikling.Api/Program.cs`](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Program.cs) (Minimal API), [`src/Stikling.Web/Services/BackupService.cs`](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/BackupService.cs) (Backup and export), [`src/Stikling.Web/Services/SyncRunner.cs`](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/SyncRunner.cs) (Sync runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web app"]
  node_webapp["Blazor app<br/>[Program.cs]"]
end

subgraph group_domain["Plant domain"]
  node_plant["Plant records<br/>[PlantService.cs]"]
  node_propagation["Propagation batches"]
  node_timeline["Photo history<br/>[TimelineService.cs]"]
  node_care["Care and pests<br/>[CareService.cs]"]
  node_today["Today tasks<br/>[Today]"]
  node_rooms["Rooms and supplies<br/>[RoomService.cs]"]
  node_names["Plant names"]
end

subgraph group_local["Local data"]
  node_localdb[("IndexedDB")]
  node_photos["Photo handling<br/>[PhotoService.cs]"]
  node_backup["Backup and export<br/>[BackupService.cs]"]
end

subgraph group_account["Accounts and sync"]
  node_accountsvc["Account service<br/>[AccountService.cs]"]
  node_sync["Sync runner<br/>[SyncRunner.cs]"]
  node_api_client["API client<br/>[StiklingApi.cs]"]
end

subgraph group_server["Sync API"]
  node_api["Minimal API<br/>[Program.cs]"]
  node_auth["Clerk sign-in"]
  node_personctx["Collection access<br/>[CurrentPerson.cs]"]
  node_records["Record sync<br/>[RecordEndpoints.cs]"]
  node_export["Account export<br/>[ExportEndpoints.cs]"]
  node_sqldb[("SQL database")]
  node_blob[("Photo blob storage<br/>[PhotoStorage.cs]")]
end

node_person(("Plant keeper"))

node_person -->|"uses"| node_webapp
node_webapp -->|"records plants"| node_plant
node_webapp -->|"tracks batches"| node_propagation
node_webapp -->|"logs care"| node_care
node_webapp -->|"reviews tasks"| node_today
node_webapp -->|"organizes places"| node_rooms
node_webapp -->|"suggests names"| node_names
node_plant -->|"records changes"| node_timeline
node_propagation -->|"records history"| node_timeline
node_webapp -->|"stores offline"| node_localdb
node_webapp -->|"handles photos"| node_photos
node_person -->|"exports data"| node_backup
node_backup -->|"reads records"| node_localdb
node_backup -->|"reads images"| node_photos
node_person -->|"signs in"| node_accountsvc
node_accountsvc -.->|"starts sync"| node_sync
node_sync -.->|"syncs local data"| node_localdb
node_sync -.->|"sends requests"| node_api_client
node_api_client -->|"calls API"| node_api
node_api -->|"authenticates"| node_auth
node_api -->|"resolves collection"| node_personctx
node_api -->|"routes records"| node_records
node_api -->|"routes exports"| node_export
node_api -->|"uses database"| node_sqldb
node_api -->|"uses photo storage"| node_blob
node_export -->|"reads photos"| node_blob
node_export -->|"reads account data"| node_sqldb

click node_webapp "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Program.cs"
click node_plant "https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Plants/PlantService.cs"
click node_propagation "https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Propagations/PropagationService.cs"
click node_timeline "https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Timeline/TimelineService.cs"
click node_care "https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Care/CareService.cs"
click node_today "https://github.com/laugem/stikling/tree/main/src/Stikling.Core/Today"
click node_rooms "https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Rooms/RoomService.cs"
click node_names "https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Names/PlantNameService.cs"
click node_localdb "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/IndexedDbRepositories.cs"
click node_photos "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/PhotoService.cs"
click node_backup "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/BackupService.cs"
click node_accountsvc "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/AccountService.cs"
click node_sync "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/SyncRunner.cs"
click node_api_client "https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/StiklingApi.cs"
click node_api "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Program.cs"
click node_auth "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Auth/ClerkAuthentication.cs"
click node_personctx "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/People/CurrentPerson.cs"
click node_records "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Sync/RecordEndpoints.cs"
click node_export "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/People/ExportEndpoints.cs"
click node_sqldb "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Data/StiklingDbContext.cs"
click node_blob "https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Photos/PhotoStorage.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp toneBlue
class node_plant,node_propagation,node_timeline,node_care,node_today,node_rooms,node_names toneAmber
class node_localdb,node_photos,node_backup toneMint
class node_accountsvc,node_sync,node_api_client toneRose
class node_api,node_auth,node_personctx,node_records,node_export,node_sqldb,node_blob,node_person toneIndigo
```

## Components

### Web app

- [Blazor app](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Program.cs): `src/Stikling.Web/Program.cs`

### Plant domain

- [Plant records](https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Plants/PlantService.cs): `src/Stikling.Core/Plants/PlantService.cs`
- [Propagation batches](https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Propagations/PropagationService.cs): `src/Stikling.Core/Propagations/PropagationService.cs`
- [Photo history](https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Timeline/TimelineService.cs): `src/Stikling.Core/Timeline/TimelineService.cs`
- [Care and pests](https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Care/CareService.cs): `src/Stikling.Core/Care/CareService.cs`
- [Today tasks](https://github.com/laugem/stikling/tree/main/src/Stikling.Core/Today): `src/Stikling.Core/Today`
- [Rooms and supplies](https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Rooms/RoomService.cs): `src/Stikling.Core/Rooms/RoomService.cs`
- [Plant names](https://github.com/laugem/stikling/blob/main/src/Stikling.Core/Names/PlantNameService.cs): `src/Stikling.Core/Names/PlantNameService.cs`

### Local data

- [IndexedDB](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/IndexedDbRepositories.cs): `src/Stikling.Web/Services/IndexedDbRepositories.cs`
- [Photo handling](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/PhotoService.cs): `src/Stikling.Web/Services/PhotoService.cs`
- [Backup and export](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/BackupService.cs): `src/Stikling.Web/Services/BackupService.cs`

### Accounts and sync

- [Account service](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/AccountService.cs): `src/Stikling.Web/Services/AccountService.cs`
- [Sync runner](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/SyncRunner.cs): `src/Stikling.Web/Services/SyncRunner.cs`
- [API client](https://github.com/laugem/stikling/blob/main/src/Stikling.Web/Services/StiklingApi.cs): `src/Stikling.Web/Services/StiklingApi.cs`

### Sync API

- [Minimal API](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Program.cs): `src/Stikling.Api/Program.cs`
- [Clerk sign-in](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Auth/ClerkAuthentication.cs): `src/Stikling.Api/Auth/ClerkAuthentication.cs`
- [Collection access](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/People/CurrentPerson.cs): `src/Stikling.Api/People/CurrentPerson.cs`
- [Record sync](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Sync/RecordEndpoints.cs): `src/Stikling.Api/Sync/RecordEndpoints.cs`
- [Account export](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/People/ExportEndpoints.cs): `src/Stikling.Api/People/ExportEndpoints.cs`
- [SQL database](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Data/StiklingDbContext.cs): `src/Stikling.Api/Data/StiklingDbContext.cs`
- [Photo blob storage](https://github.com/laugem/stikling/blob/main/src/Stikling.Api/Photos/PhotoStorage.cs): `src/Stikling.Api/Photos/PhotoStorage.cs`

### Other components

- **Plant keeper**

## Connections

- Plant keeper → Blazor app: uses
- Blazor app → Plant records: records plants (evidence: `src/Stikling.Web/Program.cs`)
- Blazor app → Propagation batches: tracks batches (evidence: `src/Stikling.Web/Program.cs`)
- Blazor app → Care and pests: logs care (evidence: `src/Stikling.Web/Program.cs`)
- Blazor app → Today tasks: reviews tasks (evidence: `src/Stikling.Web/Program.cs`)
- Blazor app → Rooms and supplies: organizes places (evidence: `src/Stikling.Web/Program.cs`)
- Blazor app → Plant names: suggests names (evidence: `src/Stikling.Web/Program.cs`)
- Plant records → Photo history: records changes (evidence: `src/Stikling.Core/Plants/PlantService.cs`)
- Propagation batches → Photo history: records history (evidence: `src/Stikling.Core/Propagations/PropagationService.cs`)
- Blazor app → IndexedDB: stores offline (evidence: `src/Stikling.Web/Program.cs`)
- Blazor app → Photo handling: handles photos (evidence: `src/Stikling.Web/Program.cs`)
- Plant keeper → Backup and export: exports data
- Backup and export → IndexedDB: reads records (evidence: `src/Stikling.Web/Services/BackupService.cs`)
- Backup and export → Photo handling: reads images (evidence: `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 (evidence: `src/Stikling.Api/Program.cs`)
- Minimal API → Record sync: routes records
- Minimal API → Account export: routes exports (evidence: `src/Stikling.Api/Program.cs`)
- Minimal API → SQL database: uses database (evidence: `src/Stikling.Api/Program.cs`)
- Minimal API → Photo blob storage: uses photo storage (evidence: `src/Stikling.Api/Program.cs`)
- Account export → Photo blob storage: reads photos (evidence: `src/Stikling.Api/People/ExportEndpoints.cs`)
- Account export → SQL database: reads account data (evidence: `src/Stikling.Api/People/ExportEndpoints.cs`)
