vibecarbon 0.1.7 → 0.2.0

package/carbon/content/docs/optional-services.mdx

@@ -1,160 +0,0 @@
----
-title: "Optional Services"
-description: "Add workflow automation, analytics, caching, monitoring, and CI/CD to your project."
-order: 10
----
-
-## Overview
-
-Vibecarbon ships with a core stack (Supabase, Traefik, Hono API, React SPA). You can extend it with optional services using the CLI:
-
-```bash
-# Interactive — prompts for which service to add
-npx vibecarbon add
-
-# Or seed the service name to skip the prompt
-npx vibecarbon add <service>
-```
-
-Each service adds Docker Compose files, Kubernetes manifests, environment variables, and feature flags to your project. Running the command multiple times is safe — it won't duplicate anything.
-
-```bash
-# See available services in the interactive prompt body
-npx vibecarbon add
-
-# Remove a previously added service
-npx vibecarbon remove <service>
-```
-
-## n8n — Workflow Automation
-
-A self-hosted workflow automation platform for building integrations, scheduled jobs, and webhook-driven pipelines.
-
-```bash
-npx vibecarbon add n8n
-```
-
-**What gets added:**
-- `docker-compose.n8n.yml` — n8n container with PostgreSQL backend
-- `k8s/base/n8n/` — Kubernetes manifests
-- `volumes/db/n8n-init.sh` — Database initialization script
-- Environment variables: `N8N_WEBHOOK_URL`, `N8N_API_KEY`
-- Feature flags: `VITE_N8N_ENABLED`, `N8N_ENABLED`
-
-| Setting | Value |
-|---------|-------|
-| Dev URL | http://n8n.localhost |
-| Port | 5678 |
-| Production auth | Traefik ForwardAuth (`super_admin` role) |
-
-## Metabase — Business Intelligence
-
-A self-hosted analytics dashboard that connects directly to your Supabase PostgreSQL database.
-
-```bash
-npx vibecarbon add metabase
-```
-
-**What gets added:**
-- `docker-compose.metabase.yml` — Metabase container
-- `k8s/base/metabase/` — Kubernetes manifests
-- `volumes/db/metabase-init.sh` — Database initialization script
-- Environment variables: `METABASE_ADMIN_EMAIL`, `METABASE_ADMIN_PASSWORD`
-- Feature flags: `VITE_METABASE_ENABLED`, `METABASE_ENABLED`
-
-| Setting | Value |
-|---------|-------|
-| Dev URL | http://metabase.localhost |
-| Port | 3001 |
-| Production auth | Traefik ForwardAuth (`super_admin` role) |
-
-## Redis — Caching & Sessions
-
-An in-memory data store for server-side caching, rate limiting, and session storage.
-
-```bash
-npx vibecarbon add redis
-```
-
-**What gets added:**
-- `docker-compose.redis.yml` — Redis container
-- `k8s/base/redis/` — Kubernetes manifests
-- Environment variables: `REDIS_PASSWORD` (auto-generated)
-- Feature flags: `VITE_REDIS_ENABLED`, `REDIS_ENABLED`
-
-| Setting | Value |
-|---------|-------|
-| Host | localhost:6379 |
-| Credentials | Stored in `.env.local` (`REDIS_PASSWORD`) |
-
-When `REDIS_URL` is set, the built-in rate limiter automatically uses Redis for distributed limiting across multiple replicas. Without Redis, it falls back to an in-memory store — this works for single-instance deployments but does not share state across replicas.
-
-## Observability — Monitoring Stack
-
-Enables the built-in Prometheus, Grafana, and Loki stack for metrics, dashboards, and log aggregation.
-
-```bash
-npx vibecarbon add observability
-```
-
-**What gets added:**
-- Enables `docker-compose.observability.yml` (already bundled in your project)
-- Feature flags: `VITE_OBSERVABILITY_ENABLED`, `OBSERVABILITY_ENABLED`
-
-| Setting | Value |
-|---------|-------|
-| Grafana URL | http://grafana.localhost |
-| Prometheus Port | 9190 |
-| Loki Port | 3100 |
-| Production auth | Traefik ForwardAuth (`super_admin` role) |
-
-## GitHub — Repository & CI/CD
-
-CI/CD lives in `vibecarbon configure`, not `vibecarbon add`. It creates the GitHub repository (if missing), installs the canonical build + deploy workflows under `.github/workflows/`, rewrites image references to `ghcr.io/<owner>/<project>`, and flips `cicdEnabled: true` in `vibecarbon.json`.
-
-```bash
-npx vibecarbon configure
-```
-
-Pick **CI/CD** from the feature list. The wizard handles repo creation, image-ref rewriting, and workflow installation in one pass.
-
-**Prerequisites:** The [GitHub CLI](https://cli.github.com/) (`gh`) must be installed and authenticated.
-
-**What gets added:**
-- `.github/workflows/vibecarbon-build.yml` — image build pipeline
-- `.github/workflows/deploy.yml` — k8s push-deploy pipeline
-- Container image + Flux GitRepository references updated to `<owner>/<project>`
-
-## Production Auth for Admin Services
-
-In development, n8n, Metabase, and Grafana are accessible without authentication. In production, they are protected by Traefik ForwardAuth — only users with the `super_admin` role can access them.
-
-The dev override compose files disable this requirement locally. When adding a new service that needs protection, follow the same pattern:
-
-1. Add `traefik.http.routers.<name>.middlewares=super-admin-auth@file` in the service compose file
-2. Create a dev override that sets the middleware to empty
-
-## Feature Flags
-
-Each service sets client and server feature flags in `.env.local`:
-
-| Service | Client Flag | Server Flag |
-|---------|------------|-------------|
-| n8n | `VITE_N8N_ENABLED` | `N8N_ENABLED` |
-| Metabase | `VITE_METABASE_ENABLED` | `METABASE_ENABLED` |
-| Redis | `VITE_REDIS_ENABLED` | `REDIS_ENABLED` |
-| Observability | `VITE_OBSERVABILITY_ENABLED` | `OBSERVABILITY_ENABLED` |
-
-Use these flags to conditionally render UI elements or enable server-side integrations:
-
-```typescript
-// Client-side
-if (import.meta.env.VITE_N8N_ENABLED === 'true') {
-  // Show n8n link in admin sidebar
-}
-
-// Server-side
-if (process.env.REDIS_ENABLED === 'true') {
-  // Use Redis for caching
-}
-```

package/carbon/src/client/components/MetricsStrip.tsx

@@ -1,48 +0,0 @@
-import { motion, useInView } from 'framer-motion';
-import { useRef } from 'react';
-import { useTranslation } from 'react-i18next';
-
-export function MetricsStrip() {
-  const { t } = useTranslation();
-  const ref = useRef<HTMLElement>(null);
-  const isInView = useInView(ref, { once: true, margin: '-50px' });
-
-  const METRICS = [
-    { value: t('landing.metrics.time.value'), label: t('landing.metrics.time.label') },
-    { value: t('landing.metrics.services.value'), label: t('landing.metrics.services.label') },
-    { value: t('landing.metrics.config.value'), label: t('landing.metrics.config.label') },
-    { value: t('landing.metrics.commands.value'), label: t('landing.metrics.commands.label') },
-  ];
-
-  return (
-    <section ref={ref} className="relative overflow-hidden border-y border-border/30">
-      <div className="absolute inset-x-0 top-0 h-px bg-gradient-to-r from-transparent via-primary/30 to-transparent" />
-      <div className="absolute inset-x-0 bottom-0 h-px bg-gradient-to-r from-transparent via-primary/30 to-transparent" />
-
-      {/* Horizontal gradient band behind */}
-      <div className="absolute inset-0 bg-gradient-to-r from-transparent via-primary/5 to-transparent" />
-      <div className="absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 w-[800px] h-[300px] rounded-full bg-primary/6 blur-[120px] pointer-events-none" />
-
-      <div className="relative mx-auto max-w-7xl px-6 py-16">
-        <div className="grid grid-cols-2 md:grid-cols-4 divide-x divide-border/30">
-          {METRICS.map((metric, i) => (
-            <motion.div
-              key={metric.label}
-              initial={{ opacity: 0, y: 20 }}
-              animate={isInView ? { opacity: 1, y: 0 } : {}}
-              transition={{ duration: 0.5, delay: i * 0.1 }}
-              className="px-6 py-4 text-center hover:bg-primary/[0.03] transition-colors duration-300"
-            >
-              <div className="metric-value text-2xl sm:text-3xl md:text-4xl font-black tracking-tight mb-2">
-                {metric.value}
-              </div>
-              <div className="text-xs sm:text-sm text-muted-foreground uppercase tracking-widest">
-                {metric.label}
-              </div>
-            </motion.div>
-          ))}
-        </div>
-      </div>
-    </section>
-  );
-}