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(17): Complete Resource Node Types phase

Juan Denis4829d72f8b54
diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md
index 6b8feb71..11820bad 100644
--- a/.planning/ROADMAP.md
+++ b/.planning/ROADMAP.md
@@ -28,7 +28,7 @@ Completed 2026-01-19 | 5 phases | Multi-environment app linking, shared DB suppo
| Phase | Name | Status | Goal |
|-------|------|--------|------|
| 16 | Workflow Canvas Foundation | **completed** | React Flow canvas with pan/zoom, node rendering, connection system |
-| 17 | Resource Node Types | pending | Create node types for Docker apps, databases, domains |
+| 17 | Resource Node Types | **completed** | Create node types for Docker apps, databases, domains |
| 18 | Node Configuration Panels | pending | Side panels for configuring each node type |
| 19 | Connection Logic | pending | Define and validate connections between nodes |
| 20 | Workflow Save/Load | pending | Save workflows to backend, load existing infrastructure |
@@ -59,22 +59,26 @@ Completed 2026-01-19 | 5 phases | Multi-environment app linking, shared DB suppo
---
-## Phase 17: Resource Node Types
+## Phase 17: Resource Node Types ✓
**Goal**: Create visual node types for Docker apps, databases, and domains
-### Tasks
-1. Design node visual styles (icons, colors, shapes)
-2. Create DockerAppNode component
-3. Create DatabaseNode component
-4. Create DomainNode component
-5. Create ServiceNode component (for future expandability)
-6. Add node palette/toolbar for adding nodes
+**Status**: Completed 2026-01-19
+
+### What Was Built
+- DockerAppNode with status, ports, memory display, multi-handles
+- DatabaseNode with type badges (MySQL, PostgreSQL, MongoDB, Redis)
+- DomainNode with SSL/DNS status badges
+- ServiceNode for future extensibility (Redis, Memcached, RabbitMQ)
+- Categorized palette (Compute, Storage, Network)
+- Node-specific styles with animated status indicators
### Success Criteria
-- [ ] Each resource type has distinct visual node
-- [ ] Nodes display key info (name, status, type)
-- [ ] Node palette allows adding new nodes
-- [ ] Nodes are draggable on canvas
+- [x] Each resource type has distinct visual node
+- [x] Nodes display key info (name, status, type)
+- [x] Node palette allows adding new nodes
+- [x] Nodes are draggable on canvas
+
+[Full Summary](./phases/17-resource-node-types/SUMMARY.md)
---
diff --git a/.planning/STATE.md b/.planning/STATE.md
index 775bc011..4a209ed8 100644
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -2,8 +2,8 @@
## Current Status
- **Milestone**: 3 - Visual Workflow Builder
-- **Current Phase**: 17 - Resource Node Types
-- **Phase Status**: Planned
+- **Current Phase**: 18 - Node Configuration Panels
+- **Phase Status**: Pending
- **Last Updated**: 2026-01-19
## Phase Progress
@@ -11,12 +11,21 @@
| Phase | Status | Started | Completed |
|-------|--------|---------|-----------|
| 16 | completed | 2026-01-19 | 2026-01-19 |
-| 17 | pending | - | - |
+| 17 | completed | 2026-01-19 | 2026-01-19 |
| 18 | pending | - | - |
| 19 | pending | - | - |
| 20 | pending | - | - |
| 21 | pending | - | - |
+## Phase 17 Summary
+Resource Node Types completed:
+- Created DockerAppNode with status, ports, memory display
+- Created DatabaseNode with type badges (MySQL, PostgreSQL, MongoDB, Redis)
+- Created DomainNode with SSL/DNS status badges
+- Created ServiceNode for future extensibility
+- Enhanced palette with Compute/Storage/Network categories
+- Added comprehensive node-specific styles with animations
+
## Phase 16 Summary
Workflow Canvas Foundation completed:
- Installed @xyflow/react (React Flow) library
diff --git a/.planning/phases/17-resource-node-types/SUMMARY.md b/.planning/phases/17-resource-node-types/SUMMARY.md
new file mode 100644
index 00000000..e51d302f
--- /dev/null
+++ b/.planning/phases/17-resource-node-types/SUMMARY.md
@@ -0,0 +1,116 @@
+# Phase 17: Resource Node Types - Summary
+
+## Overview
+Created specialized visual node types for Docker apps, databases, domains, and services with detailed displays and a categorized node palette.
+
+## Completed: 2026-01-19
+
+## What Was Built
+
+### 1. DockerAppNode Component
+**File**: `frontend/src/components/workflow/nodes/DockerAppNode.jsx`
+
+Specialized node for Docker applications displaying:
+- App name and image tag
+- Status indicator with animated dot (running/stopped/error)
+- Port mappings as pills
+- Memory usage preview
+- Multiple handles: input (left), output (right), database (bottom)
+
+### 2. DatabaseNode Component
+**File**: `frontend/src/components/workflow/nodes/DatabaseNode.jsx`
+
+Specialized node for databases displaying:
+- Database name
+- Type badge with colors (MySQL=#00758f, PostgreSQL=#336791, MongoDB=#4db33d, Redis=#dc382d)
+- Status indicator
+- Connection info (host:port)
+- Size/storage info
+- Input handle only (databases receive connections)
+
+### 3. DomainNode Component
+**File**: `frontend/src/components/workflow/nodes/DomainNode.jsx`
+
+Specialized node for domains displaying:
+- Domain name (monospace, prominent)
+- SSL status badge with icons (ShieldCheck/ShieldX/Shield)
+- DNS status indicator (propagated/pending)
+- SSL expiry date
+- Output handle only (domains connect TO apps)
+
+### 4. ServiceNode Component
+**File**: `frontend/src/components/workflow/nodes/ServiceNode.jsx`
+
+Generic service node for extensibility:
+- Service name and description
+- Type configs: Redis, Memcached, RabbitMQ, Queue
+- Configurable icon and color per type
+- Input and output handles
+
+### 5. Node Palette with Categories
+**File**: `frontend/src/pages/WorkflowBuilder.jsx`
+
+Replaced simple toolbar with categorized palette:
+- **Compute**: Docker App, Service
+- **Storage**: MySQL, PostgreSQL, MongoDB, Redis
+- **Network**: Domain
+
+Features:
+- All four node types registered in nodeTypes
+- Dynamic MiniMap coloring by node type
+- Default data passed when creating nodes
+
+### 6. Comprehensive Node Styles
+**File**: `frontend/src/styles/pages/_workflow.less`
+
+Added ~320 lines of styles:
+- Palette section styling with dividers
+- Type-specific node colors
+- Node detail styles (image, ports, memory, connection)
+- Port pills with accent color
+- Database type badges
+- SSL/DNS status badges
+- Animated status dot (pulsing for running/error states)
+- Database bottom handle positioning
+
+## Commits
+
+| Hash | Message |
+|------|---------|
+| `b9dcbe1` | feat(17-1): Create DockerAppNode component |
+| `7b21c44` | feat(17-2): Create DatabaseNode component |
+| `2fef686` | feat(17-3): Create DomainNode component |
+| `7909ca6` | feat(17-4): Create ServiceNode component |
+| `57e8a30` | feat(17-5): Register node types and add categorized palette |
+| `2750dc7` | feat(17-7): Add node-specific styles |
+
+## Files Changed
+
+| File | Type | Lines |
+|------|------|-------|
+| `frontend/src/components/workflow/nodes/DockerAppNode.jsx` | New | ~68 |
+| `frontend/src/components/workflow/nodes/DatabaseNode.jsx` | New | ~70 |
+| `frontend/src/components/workflow/nodes/DomainNode.jsx` | New | ~64 |
+| `frontend/src/components/workflow/nodes/ServiceNode.jsx` | New | ~67 |
+| `frontend/src/pages/WorkflowBuilder.jsx` | Modified | +87/-34 |
+| `frontend/src/styles/pages/_workflow.less` | Modified | +324 |
+
+## Success Criteria
+
+- [x] Each resource type has distinct visual node
+- [x] Nodes display key info (name, status, type-specific details)
+- [x] Node palette allows adding specific node types
+- [x] Nodes are draggable on canvas
+- [x] Build passes without errors
+
+## Technical Notes
+
+- All node components memoized with `React.memo()`
+- Handles use IDs for type-specific connections (input, output, database)
+- Node types registered in WorkflowBuilder: dockerApp, database, domain, service
+- MiniMap uses dynamic `nodeColor` callback for type-based coloring
+- Lucide React icons used throughout for consistency
+
+## Next Phase
+
+Phase 18 will create side panels for configuring each node type when selected.