chore(api): Add startup animation, logger config, and API dev script (#63)

apps/api/.env.example

@@ -3,3 +3,4 @@ DOCKSTAT_LOGGER_ONLY_SHOW=""
 DOCKSTAT_LOGGER_IGNORE_MESSAGES="Logger Status: active"
 DOCKSTAT_LOGGER_FULL_FILE_PATH=false
 DOCKSTAT_API_PORT="3030"
+DOCKSTAT_LOGGER_LEVEL="INFO"

apps/api/README.md

@@ -7,6 +7,8 @@ updatedAt: 2026-01-01T15:02:00.500Z
 urlId: gVYlljv3Fs
 ---
 
+![DockStatAPI Animation](https://raw.githubusercontent.com/Its4Nik/DockStat/refs/heads/DockStatAPI-readme-update/.github/assets/gifs/DockStatAPI-startup.gif)
+
 > The DockStatAPI is implemented with Elysia and exposed under the prefix `/api/v2`. The canonical route definitions are in `apps/api/src/routes/` with schemas in `apps/api/src/models/`.
 
 ## Base URL

apps/dockstat/src/lib/actions/README.md

@@ -1,9 +1,9 @@
 ---
 id: 57802308-6a42-4d47-82b6-bc553ae10e9c
-title: "Frontend: actions"
+title: "Frontend: Actions"
 collectionId: b4a5e48f-f103-480b-9f50-8f53f515cab9
 parentDocumentId: a81b5d89-a300-47ac-8ffa-a3b851645978
-updatedAt: 2026-01-01T14:27:30.440Z
+updatedAt: 2026-01-01T20:40:03.579Z
 urlId: 0tWEK43tNb
 ---
 
@@ -34,9 +34,9 @@ export async function updateProfile(input: UpdateProfileInput) {
   })
 
   if (error) {
-    throw new Error(extractEdenError({ data, error }))
+    throw new Error(String(error.value))
   }
-  
+
   return data
 }
 ```
@@ -90,4 +90,4 @@ export function ProfileForm() {
 * Always `throw` on API errors (React Query will surface it in `mutation.error`)
 * Keep **UI concerns out** of actions (no toasts, no routing, no cache invalidation here)
 * Keep input types close to the action
-* Return only what the caller needs (don't over-return)
+* Return only what the caller needs (don't over-return)

apps/dockstat/src/lib/queries/README.md

@@ -1,9 +1,9 @@
 ---
 id: da3758e1-2d46-4dd5-85c5-eb9d19ee2054
-title: "Frontend: queries"
+title: "Frontend: Queries"
 collectionId: b4a5e48f-f103-480b-9f50-8f53f515cab9
 parentDocumentId: a81b5d89-a300-47ac-8ffa-a3b851645978
-updatedAt: 2026-01-01T15:02:36.975Z
+updatedAt: 2026-01-01T20:40:14.966Z
 urlId: wadWIa69wa
 ---
 
@@ -68,4 +68,4 @@ export function Status() {
 * Always `throw` on API errors (don't return `{ error }`)
 * Return the smallest useful `data` shape
 * No UI logic here (no toasts, no redirects)
-* Keep `queryKey`s in the component (or optionally export helpers if you standardize keys later)
+* Keep `queryKey`s in the component (or optionally export helpers if you standardize keys later)

apps/dockstat/src/lib/websocketEffects/README.md

@@ -3,7 +3,7 @@ id: aab7cefb-b84b-4be9-8840-a873b69c6850
 title: "Frontend: Websockets"
 collectionId: b4a5e48f-f103-480b-9f50-8f53f515cab9
 parentDocumentId: a81b5d89-a300-47ac-8ffa-a3b851645978
-updatedAt: 2026-01-01T14:28:14.767Z
+updatedAt: 2026-01-01T20:39:33.079Z
 urlId: vcQwuQaPn0
 ---
 
@@ -78,4 +78,4 @@ new Elysia()
 
 * One effect = one socket.
 * Always return a cleanup function so the socket is closed on unmount.
-* Keep the effect **pure**: no UI, no toasts, only state synchronization.
+* Keep the effect **pure**: no UI, no toasts, only state synchronization.

apps/docs/dockstat/api-reference/README.md

@@ -83,12 +83,12 @@ Returns the overall DockerClientManager status, including worker pool metrics.
 
 ### Hosts `/docker/hosts`
 
-| Method | Path               | Description                       |
-| ------ | ------------------ | --------------------------------- |
-| GET    | `/hosts/`          | List all hosts                    |
-| GET    | `/hosts/:clientId` | Get metrics for a specific client |
-| POST   | `/hosts/add`       | Add a new host                    |
-| POST   | `/hosts/update`    | Update an existing host           |
+| Method | Path | Description |
+|----|----|----|
+| GET | `/hosts/` | List all hosts |
+| GET | `/hosts/:clientId` | Get metrics for a specific client |
+| POST | `/hosts/add` | Add a new host |
+| POST | `/hosts/update` | Update an existing host |
 
 **POST** `**/hosts/add**` **body:**
 
@@ -119,13 +119,13 @@ Returns the overall DockerClientManager status, including worker pool metrics.
 
 ### Client `/docker/client`
 
-| Method | Path                           | Description                   |
-| ------ | ------------------------------ | ----------------------------- |
-| POST   | `/client/register`             | Register a new Docker client  |
-| DELETE | `/client/delete`               | Remove a client               |
-| GET    | `/client/all/:stored`          | List all clients              |
-| POST   | `/client/monitoring/:id/start` | Start monitoring for a client |
-| POST   | `/client/monitoring/:id/stop`  | Stop monitoring for a client  |
+| Method | Path | Description |
+|----|----|----|
+| POST | `/client/register` | Register a new Docker client |
+| DELETE | `/client/delete` | Remove a client |
+| GET | `/client/all/:stored` | List all clients |
+| POST | `/client/monitoring/:id/start` | Start monitoring for a client |
+| POST | `/client/monitoring/:id/stop` | Stop monitoring for a client |
 
 **POST** `**/client/register**` **body:**
 
@@ -148,18 +148,18 @@ Returns the overall DockerClientManager status, including worker pool metrics.
 
 ### Containers `/docker/containers`
 
-| Method | Path                        | Description                     |
-| ------ | --------------------------- | ------------------------------- |
-| GET    | `/containers/all/:clientId` | Get all containers for a client |
+| Method | Path | Description |
+|----|----|----|
+| GET | `/containers/all/:clientId` | Get all containers for a client |
 
 **Response:** Array of container objects with stats.
 
 ### Manager `/docker/manager`
 
-| Method | Path                        | Description                       |
-| ------ | --------------------------- | --------------------------------- |
-| GET    | `/manager/pool-stats`       | Get worker pool statistics        |
-| POST   | `/manager/init-all-clients` | Initialize all registered clients |
+| Method | Path | Description |
+|----|----|----|
+| GET | `/manager/pool-stats` | Get worker pool statistics |
+| POST | `/manager/init-all-clients` | Initialize all registered clients |
 
 ## Metrics Routes `/api/v2/metrics`
 
@@ -169,10 +169,10 @@ Returns Prometheus-formatted metrics for the API and database.
 
 **Response 200:** Prometheus text format with:
 
-- HTTP request counters
-- Request duration histograms
-- Database size and table metrics
-- Memory usage statistics
+* HTTP request counters
+* Request duration histograms
+* Database size and table metrics
+* Memory usage statistics
 
 ## Plugin Routes `/api/v2/plugins`
 
@@ -199,16 +199,16 @@ sequenceDiagram
     API-->>Client: 200 OK
 ```
 
-| Method | Path                    | Description                              |
-| ------ | ----------------------- | ---------------------------------------- |
-| GET    | `/plugins/all`          | List all installed plugins               |
-| GET    | `/plugins/hooks`        | Get available hook handlers              |
-| GET    | `/plugins/status`       | Get plugin system status                 |
-| POST   | `/plugins/install`      | Install a plugin                         |
-| POST   | `/plugins/activate`     | Activate plugins by ID                   |
-| POST   | `/plugins/delete`       | Delete a plugin                          |
-| GET    | `/plugins/routes`       | List plugin-provided routes              |
-| ALL    | `/plugins/:id/routes/*` | Proxy requests to plugin Elysia instance |
+| Method | Path | Description |
+|----|----|----|
+| GET | `/plugins/all` | List all installed plugins |
+| GET | `/plugins/hooks` | Get available hook handlers |
+| GET | `/plugins/status` | Get plugin system status |
+| POST | `/plugins/install` | Install a plugin |
+| POST | `/plugins/activate` | Activate plugins by ID |
+| POST | `/plugins/delete` | Delete a plugin |
+| GET | `/plugins/routes` | List plugin-provided routes |
+| ALL | `/plugins/:id/routes/*` | Proxy requests to plugin Elysia instance |
 
 **POST** `**/plugins/install**` **body:**
 
@@ -242,10 +242,10 @@ sequenceDiagram
 
 ## Database Routes `/api/v2/db`
 
-| Method | Path         | Description               |
-| ------ | ------------ | ------------------------- |
-| GET    | `/db/config` | Get current configuration |
-| POST   | `/db/config` | Update configuration      |
+| Method | Path | Description |
+|----|----|----|
+| GET | `/db/config` | Get current configuration |
+| POST | `/db/config` | Update configuration |
 
 **POST** `**/db/config**` **body:** Configuration object matching `DockStatConfigTable` schema from `@dockstat/typings`.
 
@@ -281,3 +281,18 @@ All routes use a global error handler that returns structured errors:
 ## Authentication
 
 The current API implementation does not enforce authentication at the route level. For production deployments, add an authentication layer via reverse proxy or Elysia middleware.
+
+## Source Files
+
+| File | Description |
+|----|----|
+| `apps/api/src/index.ts` | API entry point |
+| `apps/api/src/routes/docker/index.ts` | Docker route aggregator |
+| `apps/api/src/routes/docker/hosts.ts` | Host management routes |
+| `apps/api/src/routes/docker/client.ts` | Client management routes |
+| `apps/api/src/routes/docker/container.ts` | Container routes |
+| `apps/api/src/routes/docker/manager.ts` | Manager routes |
+| `apps/api/src/routes/plugins/index.ts` | Plugin routes |
+| `apps/api/src/routes/db.ts` | Database configuration routes |
+| `apps/api/src/routes/metrics/prometheus.ts` | Metrics endpoint |
+| `apps/api/src/models/*.ts` | Request/response schemas |