From 7aa3e0482942ed1da5e24076ba54c22b4c6c8f5f Mon Sep 17 00:00:00 2001
From: Paul Payne <paul@payne.io>
Date: Sat, 20 Jun 2026 21:45:39 +0000
Subject: [PATCH] Change aptly from service to app and update category handling
 in docs.

---
 ADDING-APPS.md | 21 ++++++++++++++++++++-
 aptly/app.yaml |  2 +-
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/ADDING-APPS.md b/ADDING-APPS.md
index 6032e64..ed44a14 100644
--- a/ADDING-APPS.md
+++ b/ADDING-APPS.md
@@ -55,10 +55,29 @@ latest: "1"
 | `is` | Yes | Unique id for this app. Used for `requires` mapping |
 | `description` | Yes | Brief app description shown in listings |
 | `icon` | No | URL to app icon for UI display |
-| `category` | No | Category (e.g., `infrastructure`) |
+| `category` | Yes | Category for filtering in the app directory — use an established one or introduce a new one (see below) |
 | `latest` | Yes | Slot name -- directory name under `versions/` (not a version string) |
 | `upgrade` | No | Upgrade routing rules (see Upgrade Metadata below) |
 
+### Categories
+
+The UI uses `category` to populate the filter buttons in the App Directory. Use an established category when one fits — new categories are fine when an app clearly doesn't belong anywhere existing. Current categories:
+
+| Category | Use for |
+|----------|---------|
+| `services` | Wild Cloud infrastructure services (traefik, metallb, cert-manager, etc.) |
+| `database` | Database engines (postgres, mysql, redis, memcached) |
+| `productivity` | Wikis, project management, file sharing, collaboration (nextcloud, outline, taiga, etc.) |
+| `business` | ERP, CRM, accounting, forms, marketing automation (odoo, akaunting, mautic, etc.) |
+| `communication` | Chat, messaging, video conferencing, email (mattermost, jitsi, listmonk, etc.) |
+| `social` | Social networks and fediverse apps (mastodon, pixelfed, peertube, ghost, etc.) |
+| `community` | Community organizing, civic tech, decision-making (loomio, decidim, discourse, etc.) |
+| `education` | Learning management systems (moodle, chamilo) |
+| `developer` | Dev tools, code hosting, package management (gitea, aptly, etc.) |
+| `security` | VPN, password management (vaultwarden, headscale) |
+| `ai` | AI/ML inference and interfaces (vllm, open-webui) |
+| `media` | Photo and video management (immich) |
+
 ## Version Manifest (`versions/{slot}/manifest.yaml`)
 
 Each version slot contains a `manifest.yaml` with version-specific installation details: dependencies, configuration schema, and secret requirements.
diff --git a/aptly/app.yaml b/aptly/app.yaml
index fe8bb7c..d84268e 100644
--- a/aptly/app.yaml
+++ b/aptly/app.yaml
@@ -1,6 +1,6 @@
 name: aptly
 is: aptly
 description: Aptly is a Debian/Ubuntu APT repository management tool for mirroring, snapshotting, and publishing package repositories.
-category: services
+category: developer
 icon: https://github.com/aptly-dev.png
 latest: "1"