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.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
plan(13): Create Phase 13 plan - Environment Switching UI
Juan Denis2d6d6dc79800
diff --git a/.planning/phases/13-environment-switching-ui/PLAN.md b/.planning/phases/13-environment-switching-ui/PLAN.mdnew file mode 100644index 00000000..04557e1e--- /dev/null+++ b/.planning/phases/13-environment-switching-ui/PLAN.md@@ -0,0 +1,151 @@+# Phase 13: Environment Switching UI — PLAN++## Objective+Add UI components for managing environment types, linking apps as prod/dev pairs, and syncing themes between WordPress environments.++## Execution Context++**Key Files:**+- `frontend/src/pages/Applications.jsx` — App list (add environment badges)+- `frontend/src/pages/ApplicationDetail.jsx` — App detail (add linked apps section)+- `frontend/src/components/LinkedAppsSection.jsx` — New component for linked apps+- `frontend/src/components/LinkAppModal.jsx` — New modal for linking apps+- `frontend/src/styles/components/_badges.less` — Environment badge styles+- `frontend/src/styles/components/_linked-apps.less` — Linked apps section styles++**API Methods Available (from Phase 12):**+- `api.linkApp(appId, targetAppId, asEnvironment, options)`+- `api.getLinkedApps(appId)`+- `api.unlinkApp(appId)`+- `api.updateAppEnvironment(appId, environmentType)`++**Patterns to Follow:**+- Functional components with hooks+- Lucide icons (already imported in Applications.jsx)+- Status badge pattern from _badges.less+- Card-based UI for sections+- Modal pattern from CreateAppModal++## Tasks++### Task 1: Add Environment Badge to App List+**Files:** `frontend/src/pages/Applications.jsx`, `frontend/src/styles/components/_badges.less`++Add environment badge next to status badge in both list and grid views:+- Show badge only when `environment_type !== 'standalone'`+- Colors: green=production, blue=development, yellow=staging+- Badge text: "PROD", "DEV", "STAGING"+- Add linked icon indicator if `has_linked_app` is true++Update `AppRow` and `AppCard` components to display environment info.++**Verification:** Apps with environment types show colored badges.++---++### Task 2: Add Environment Filter to Apps Toolbar+**File:** `frontend/src/pages/Applications.jsx`++Add environment filter dropdown in toolbar:+- Options: All, Production, Development, Staging, Standalone+- Uses URL params like existing search/sort+- Calls `api.getApps()` with `?environment=` filter++**Verification:** Filter dropdown filters apps by environment type.++---++### Task 3: Create LinkedAppsSection Component+**Files:** `frontend/src/components/LinkedAppsSection.jsx`, `frontend/src/styles/components/_linked-apps.less`++New component showing linked apps in Overview tab:+```jsx+<LinkedAppsSection+ app={app}+ linkedApps={linkedApps}+ onLink={() => setShowLinkModal(true)}+ onUnlink={handleUnlink}+ onNavigate={(appId) => navigate(`/apps/${appId}`)}+/>+```++Features:+- Shows current environment type with colored badge+- Lists linked apps with their status+- "Link App" button to open modal+- "Unlink" button with confirmation+- Quick navigation to linked app++**Verification:** Component renders in Overview tab with linked app info.++---++### Task 4: Create LinkAppModal Component+**File:** `frontend/src/components/LinkAppModal.jsx`++Modal for linking an app to another:+- Dropdown to select target app (filtered to same type, not already linked)+- Environment type selection (This app will be: Development / Production / Staging)+- Table prefix input for WordPress apps (optional, auto-generated default)+- Checkbox: "Propagate database credentials" (default: true)+- Shows preview of what will happen+- Calls `api.linkApp()` on submit++**Verification:** Modal opens, shows compatible apps, links successfully.++---++### Task 5: Integrate Linked Apps Section into ApplicationDetail+**File:** `frontend/src/pages/ApplicationDetail.jsx`++Add LinkedAppsSection to Overview tab:+- Load linked apps on mount using `api.getLinkedApps(id)`+- Add state for `linkedApps`, `showLinkModal`+- Handle unlink with confirmation dialog+- Refresh after link/unlink operations++Update header to show environment badge next to status badge.++**Verification:** Overview tab shows linked apps section with functional link/unlink.++---++### Task 6: Add Environment Settings to Settings Tab+**File:** `frontend/src/pages/ApplicationDetail.jsx`++Add environment configuration section in SettingsTab:+- Current environment type display+- Dropdown to change environment type (standalone apps only)+- Warning when changing linked app environment+- "Unlink from [app name]" button for linked apps++**Verification:** Can change environment type for standalone apps.++---++## Verification++```javascript+// In browser console, verify:+// 1. Apps with environment_type show badges+// 2. Filter dropdown works+// 3. Linked apps section appears in Overview+// 4. Link modal shows compatible apps+// 5. Link/unlink operations work+```++## Success Criteria+- [ ] Environment badges visible in app list (list and grid views)+- [ ] Environment filter dropdown in toolbar+- [ ] Linked apps section in Overview tab+- [ ] Link app modal with target selection+- [ ] Unlink functionality with confirmation+- [ ] Environment type editable in Settings tab++## Output+- Modified: `frontend/src/pages/Applications.jsx`+- Modified: `frontend/src/pages/ApplicationDetail.jsx`+- Created: `frontend/src/components/LinkedAppsSection.jsx`+- Created: `frontend/src/components/LinkAppModal.jsx`+- Modified: `frontend/src/styles/components/_badges.less`+- Created: `frontend/src/styles/components/_linked-apps.less`