vibespot 1.3.0 → 1.5.0

package/README.md

@@ -36,8 +36,10 @@ Opens a browser with:
 - **Project sidebar** — create, open, resume, or delete projects; page tree shows all templates with type badges and module counts
 - **Module management** — reorder via drag-and-drop, edit fields, delete modules from module list or module library
 - **Starter templates** — SaaS, Portfolio, Restaurant, Event, Coming Soon, Blog — pre-built page bundles for instant preview with no AI wait
-- **Content types** — landing pages, email templates, and blog templates all supported from the UI page type dropdown
+- **Content types** — landing pages, email templates, and blog templates all supported from asset-type cards and the page type dropdown
+- **Email client preview** — renders your email in Gmail, Outlook Desktop, and Apple Mail with per-client rendering notes
 - **Split-pane view** — preview + code editor side by side in a 50/50 layout
+- **Project overview table** — sortable table with page, email, module, and brand asset counts per project, plus bulk duplicate/delete
 - **Brand kit enforcement** — colors, fonts, and logo are injected as constraints into AI generation; validator warns on off-brand values
 - **Interact mode** — unified mode that auto-detects whether you're editing content inline or referencing modules in chat
 - **Undo/redo** — Ctrl+Z / Ctrl+Y step through version history; a compact timeline strip shows every generation step
@@ -137,6 +139,7 @@ vibeSpot needs an AI engine to generate code. Use **one** of these:
 | Claude OAuth | Run `claude setup-token` → paste token | Uses your Claude Pro/Max subscription |
 | OpenAI API | No install — just need an API key | Any OpenAI model |
 | Gemini API | No install — just need an API key | Google Gemini models |
+| [Langdock](https://langdock.com) | No install — just need a Langdock API key | EU-hosted gateway (Frankfurt), GDPR-compliant |
 | [Claude Code](https://claude.ai/code) | `npm install -g @anthropic-ai/claude-code` | Uses your Claude subscription |
 | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | Uses your Google AI account |
 | [OpenAI Codex](https://github.com/openai/codex) | `npm install -g @openai/codex` | Uses your OpenAI account |
@@ -153,6 +156,18 @@ The browser opens automatically. Enter your API key in the setup screen, create
 
 Open **Settings → HubSpot** and add your account with a Personal Access Key (PAK). vibeSpot connects directly via the HubSpot API — no CLI installation needed. You can also switch to legacy CLI mode if you prefer.
 
+### Run with Docker
+
+Prefer not to install Node.js? Pull the published image instead:
+
+```bash
+docker run --rm -p 4200:4200 \
+  -e ANTHROPIC_API_KEY=sk-ant-... \
+  ghcr.io/borismichel/vibespot:latest
+```
+
+Or use the bundled `docker-compose.yml` (Caddy + Postgres + auth-gate slot) for production deployments. See [docs/docker.md](docs/docker.md) for the full guide.
+
 ## After Building Your Page
 
 Once your modules are ready:
@@ -166,10 +181,31 @@ Once your modules are ready:
 7. Edit text, images, and colors in the page editor
 8. Preview and publish!
 
+## Docker Deployment
+
+Run vibeSpot as a containerised service for your team — LAN, VPN, or HTTPS.
+
+```bash
+cp .env.example .env        # set at least one AI API key
+docker compose up -d         # plain HTTP on port 4200
+```
+
+For public HTTPS with automatic TLS via Caddy:
+
+```bash
+# In .env, set VIBESPOT_DOMAIN=vibespot.example.com
+docker compose --profile https up -d
+```
+
+All AI keys, engine selection, and integrations are configurable via environment variables — see `.env.example` for the full list. Themes and config persist across container restarts via named Docker volumes.
+
+For reverse proxy configs (nginx, Traefik, k8s Ingress), Kubernetes manifests, backup/restore, and security guidance, see the full **[Docker Deployment Guide](docs/docker-deployment.md)**.
+
 ## Commands
 
 ```bash
 vibespot              # Vibe coding web UI (default)
+vibespot email        # Start in email template mode
 vibespot wizard       # Classic CLI wizard
 vibespot init         # Check and install required tools
 vibespot convert      # Convert a React project (no upload)
@@ -186,30 +222,44 @@ Most users only need `npx vibespot` — the web UI handles everything.
 
 Settings are managed in the **Settings** panel (tabbed: AI, HubSpot, Figma, GitHub, vibeSpot) and saved in `~/.vibespot/config.json`:
 
-- `aiEngine` — Your preferred AI engine (`anthropic-api`, `claude-oauth`, `openai-api`, `gemini-api`, `claude-code`, `gemini-cli`, `codex-cli`)
-- `anthropicApiKey`, `openaiApiKey`, `geminiApiKey` — API keys (stored locally, never sent except to the provider)
+- `aiEngine` — Your preferred AI engine (`anthropic-api`, `claude-oauth`, `openai-api`, `gemini-api`, `langdock-api`, `claude-code`, `gemini-cli`, `codex-cli`)
+- `anthropicApiKey`, `openaiApiKey`, `geminiApiKey`, `langdockApiKey` — API keys (stored locally, never sent except to the provider)
+- `langdockBaseUrl` — Override for self-hosted Langdock deployments (default: `https://api.langdock.com/anthropic`)
 - `hubspotAccounts` — Connected HubSpot accounts (PAK-based auth)
 - `hubspotUploadMode` — `api` (default, direct API) or `cli` (legacy, requires HubSpot CLI)
 - `agenticConcurrency` — Max parallel module generation calls (default: 20)
 - `figmaToken` — Figma Personal Access Token for design import
 - `enabledCLITools` — Which CLI tools to detect on settings load
 
+All settings can also be provided via environment variables for headless/Docker deployments — see [Docker Deployment](docs/docker-deployment.md) and `.env.example` for the full list.
+
 ## What's New
 
 ### Unreleased
+- **Docker deployment** — run vibeSpot as a containerised service with `docker compose up -d`. Includes Caddy auto-HTTPS, env var configuration for all AI keys/integrations, named volume persistence, health check endpoint, and deployment docs for nginx/k8s
+- **Langdock AI adapter** — EU-hosted AI engine via Langdock gateway
+
+### v1.3.1
+- **Project overview table** — sortable table view for all projects with page, email, module, and brand asset counts
+- **Bulk operations** — select multiple projects for bulk duplicate or delete
+- **Email client preview** — preview emails as they render in Gmail, Outlook Desktop, and Apple Mail
+- **Pipeline robustness** — auto-regenerate modules with broken fieldsJson; tightened similarity checks
+- **Email deploy fixes** — correct dnd_area naming, module references for drag-and-drop editor, deploy UX improvements
+- **Security hardening** — eliminated shell injection in git operations, path-traversal guards on theme routes
+
+### v1.3.0
+- **Email template generation** — full pipeline support for HubSpot email templates: email-specific prompts, table-based layout, MSO/VML compatibility, 3 email starters, 5 email plan templates, and email validator auto-fix
 - **Multi-page sites** — create full HubSpot sites from a single prompt with shared modules, page tree sidebar, and cross-page navigation validation
 - **Inline WYSIWYG editing** — click text, images, and links directly in the live preview to edit inline
 - **Per-section visual controls** — hover toolbar with color pickers, spacing sliders, image swap, and font size controls
 - **Blog template generation** — blog as a content type with HubSpot blog variable support and a Blog Content Hub starter template
 - **Split-pane view** — preview + code editor side by side
 - **Brand kit enforcement** — colors, fonts, and logo injected as AI constraints with off-brand warnings
-- **Workspace tab navigation** — Pages, Brand, Library, Marketplace, Settings tabs replace the flat dashboard
+- **Workspace tab navigation** — Pages, Brand, Library, Marketplace, Settings tabs
+- **Guided entry with asset-type cards** — Landing Page, Email, Website, Blog Post, From Template, and Import
 - **First-visit onboarding** — 3-step walkthrough for new users
-- **CSS token system** — comprehensive design tokens for spacing, typography, z-index, transitions, and component library
-- **HubSpot terminology alignment** — UI copy uses HubSpot's canonical terms (Module, Module Library, Brand Kit)
-
-### v1.3.0
-- **Email template generation** — full pipeline support for HubSpot email templates: email-specific prompts, table-based layout, MSO/VML compatibility, 3 email starters, 5 email plan templates, and email validator auto-fix
+- **Material Design SVG icons** — replaced UI emoji glyphs with crisp SVG icons
+- **Project assets browser** — Library tab shows project files (images, fonts, scripts) instead of starter templates
 
 ### v1.2.0
 - **Inverse pipeline (HubSpot → vibeSpot)** — reverse-engineer imported HubSpot themes: design token extraction, module graph, field schema flags, and round-trip risk detection