Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

docs: adopt numbered filenames for docs/plans and update references

Juan Denis7b4550456810
diff --git a/.gitignore b/.gitignore
index 2159cca7..ab71d70e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -133,8 +133,6 @@ SECURITY_AND_CODE_AUDIT.md
!agent/internal/setupui/serverkit_header.png
docs/PLAN_AGENT_FLEET.md
/docs/plans
-/docs/plans/BACKUP_PROTECTION_PLAN.md
-docs/plans/CLOUDFLARE_INTEGRATION_ROADMAP.md
/.agents
/.extension-platform-plan/
/.claude
diff --git a/AGENTS.md b/AGENTS.md
index 027a72db..f0e83cac 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -143,7 +143,7 @@ add Tailwind utility classes, CSS-in-JS, or new inline styles.
- **Fonts**: `IBM Plex Sans` / `IBM Plex Mono` (the established SCSS stack).
**Migration status**: Tailwind removal is in progress (see
-`docs/plans/FRONTEND_UX_TAILWIND_CLEANUP_PLAN.md`). Do not introduce new Tailwind
+`docs/plans/05_FRONTEND_UX_TAILWIND_CLEANUP_PLAN.md`). Do not introduce new Tailwind
usage; convert any you touch to the SCSS equivalents above.
## Adding a New Feature (Full Stack)
diff --git a/backend/serverkit_installer/README.md b/backend/serverkit_installer/README.md
index b4100851..b902d9c5 100644
--- a/backend/serverkit_installer/README.md
+++ b/backend/serverkit_installer/README.md
@@ -1,7 +1,7 @@
# serverkit_installer
Phase 5 foundation from the
-[Installer/Updater/Uninstaller Hardening Plan](../../docs/plans/INSTALLER_UPDATER_UNINSTALLER_HARDENING_PLAN.md)
+[Installer/Updater/Uninstaller Hardening Plan](../../docs/plans/07_INSTALLER_UPDATER_UNINSTALLER_HARDENING_PLAN.md)
(§8). A stdlib-only, import-safe, unit-tested Python port of the bash installer's
detection and orchestration logic.
diff --git a/backend/serverkit_installer/__init__.py b/backend/serverkit_installer/__init__.py
index 2d0e2156..b66c07c4 100644
--- a/backend/serverkit_installer/__init__.py
+++ b/backend/serverkit_installer/__init__.py
@@ -2,7 +2,7 @@
A stdlib-only, import-safe, unit-tested Python package that mirrors the bash
installer's distro/dependency/firewall/service logic. Per the hardening plan
-(docs/plans/INSTALLER_UPDATER_UNINSTALLER_HARDENING_PLAN.md §8) this is an
+(docs/plans/07_INSTALLER_UPDATER_UNINSTALLER_HARDENING_PLAN.md §8) this is an
*additive foundation*: install.sh remains the canonical installer. The point of
porting the stabilized bash logic here is to get unit-testable orchestration and
a single source of truth for distro detection that the backend can eventually
diff --git a/backend/tests/test_app_volumes.py b/backend/tests/test_app_volumes.py
index 0a67c378..bc87db46 100644
--- a/backend/tests/test_app_volumes.py
+++ b/backend/tests/test_app_volumes.py
@@ -1,6 +1,6 @@
"""Per-app managed volumes — model, service, deploy wiring, and API.
-Covers the proving points from docs/plans/APP_MANAGED_VOLUMES.md:
+Covers the proving points from docs/plans/10_APP_MANAGED_VOLUMES.md:
- create persists a row AND a namespaced Docker volume
- a duplicate mount path is refused
- delete(wipe=False) never calls `docker volume rm`
diff --git a/backend/tests/test_container_registry.py b/backend/tests/test_container_registry.py
index a0c545ca..45ef9c85 100644
--- a/backend/tests/test_container_registry.py
+++ b/backend/tests/test_container_registry.py
@@ -1,6 +1,6 @@
"""Container registry authentication — service, API, and deploy-path wiring.
-Covers the proving points from docs/plans/CONTAINER_REGISTRY_AUTH.md:
+Covers the proving points from docs/plans/09_CONTAINER_REGISTRY_AUTH.md:
- encrypt/decrypt round-trip, secret never serialized
- `login()` pipes the secret via stdin and never places it on argv
- `pull_image` runs login -> pull -> logout in order, and still logs out on
diff --git a/backend/tests/test_managed_database.py b/backend/tests/test_managed_database.py
index ac4b095b..f4604bdc 100644
--- a/backend/tests/test_managed_database.py
+++ b/backend/tests/test_managed_database.py
@@ -1,6 +1,6 @@
"""Managed database resource — service, backup FK wiring, and API.
-Covers the proving points from docs/plans/MANAGED_DATABASE_RESOURCE.md:
+Covers the proving points from docs/plans/11_MANAGED_DATABASE_RESOURCE.md:
- provisioning persists a row; adopt is idempotent
- build_connection_uri is correct per engine and masks the secret by default
- sync_state flags a dropped-but-tracked DB as drifted
diff --git a/frontend/src/styles/base/_utilities.scss b/frontend/src/styles/base/_utilities.scss
index 76b4bd59..356cc789 100644
--- a/frontend/src/styles/base/_utilities.scss
+++ b/frontend/src/styles/base/_utilities.scss
@@ -197,7 +197,7 @@
// TAILWIND-REMOVAL COMPATIBILITY LAYER
// ============================================
// Added when Tailwind was removed from the build
-// (docs/plans/FRONTEND_UX_TAILWIND_CLEANUP_PLAN.md, Phase 2). These re-create,
+// (docs/plans/05_FRONTEND_UX_TAILWIND_CLEANUP_PLAN.md, Phase 2). These re-create,
// theme-aware, the remaining Tailwind utility classes still referenced in
// pages/components so dropping the Tailwind dependency causes no visual
// regression. New code should prefer semantic SCSS classes over these.