# Duurzame kennis over UmbrelApps

Cross-plan kennis: dingen die blijven gelden en die geen enkel plan bezit. Wat bij één plan hoort staat
daar; wat naslag is staat in [Referenties/](Referenties/). Geldt een stuk maar voor één van de twee apps,
dan staat dat in de kop.

## De app is voor eigen gebruik, niet voor distributie (Electrum Gate)

Vastgelegd 18-08-2026 op aangeven van de gebruiker. De repo is publiek, maar dat is een **technische
voorwaarde en geen publicatiedoel**: umbreld kloont een community app store anoniem en kan geen
inloggegevens aanbieden, dus privé kan niet. De app is bedoeld voor één Umbrel, die van de gebruiker.

Waarom dit opgeschreven staat: het is het soort context dat een latere sessie niet kan afleiden uit de
code, en dat zonder vermelding tot werk leidt dat niemand gevraagd heeft. Concreet stuurt het deze
afwegingen:

- **Generiek maken is geen doel op zich.** Configuratie uit de code halen blijft nuttig, maar de reden is
  dat een domeinwijziging of een poortbotsing anders een zoektocht door drie bestanden wordt, niet dat
  iemand anders de app moet kunnen draaien. Weeg extra instelbaarheid dus tegen die maatstaf.
- **Presentatie mag mager blijven.** Een eigen icoon is nuttig, want dat is de tegel die de gebruiker
  dagelijks ziet. Gallery-afbeeldingen, uitgebreide release notes en een nette `submitter` zijn dat
  nauwelijks: die zijn er voor een winkelpagina die niemand bezoekt. Doe wat het manifest verplicht en
  niet meer.
- **Het domein in de publieke historie is een geaccepteerd feit.** De repo is gepusht vóór de opschoning,
  bewust, met als afweging dat een niet-aangekondigde repo op een eigen server niet gevonden wordt. Haal
  dat niet opnieuw op als bezwaar en stel er geen werk voor uit; zie het plan **Appstore**, `OPEN.md`
  punt 3.
- **Achterwaartse compatibiliteit is geen eis.** Er zijn geen andere installaties. Een wijziging die de
  configuratie of de app-id verandert mag gewoon, mits de gebruiker weet dat hij één keer opnieuw moet
  installeren.

Wat het **niet** verandert: de eisen van umbrelOS zelf. Prefix in het app-id, `app_proxy`, gepinde images
en een geldig manifest zijn geen etiquette maar voorwaarden om te starten. Zie
[Referenties/Umbrel-appstore-spec.md](Referenties/Umbrel-appstore-spec.md).