Initial release — AI-powered toolkit for local business web redesign

Complete workflow: prospect businesses via Google Maps, scrape existing
sites, generate modern redesigns with AI, and present before/after
showcases to clients. Everything runs in Docker.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: EnriqueLop

.dockerignore

@@ -0,0 +1,14 @@
+.env
+config.operator.json
+.claude
+.git
+.github
+node_modules
+prospects/prospects.json
+prospects/searches.json
+prospects/fetched
+prospects/analysis
+projects
+planes
+pipeline.html
+.DS_Store

.env.example

@@ -0,0 +1,5 @@
+# Google Places API (New) — required for prospecting and business data
+# Get yours at: https://console.cloud.google.com/apis/credentials
+# Enable "Places API (New)" in your project
+# Free tier: 5,000 requests/month
+GOOGLE_PLACES_API_KEY=your-api-key-here

.github/workflows/docker-publish.yml

@@ -0,0 +1,39 @@
+name: Build and push Docker image
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'Dockerfile'
+      - 'package.json'
+      - 'package-lock.json'
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+            ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.sha }}

.gitignore

@@ -0,0 +1,33 @@
+node_modules/
+.DS_Store
+
+# Secrets and personal config
+.env
+.env.local
+config.operator.json
+
+# Claude Code local settings (may contain API keys)
+.claude/settings.local.json
+
+# Prospect data (contains real business info)
+prospects/prospects.json
+prospects/searches.json
+prospects/fetched/
+prospects/analysis/
+
+# Project data (contains client info)
+projects/
+
+# Internal plans and notes
+planes/
+
+# Generated files
+pipeline.html
+
+# Docker artifacts
+docker/analyzer/node_modules/
+
+# OS files
+Thumbs.db
+*.swp
+*.swo

CLAUDE.md

@@ -0,0 +1,7 @@
+# Quartier
+
+Read and follow the instructions in `PLAYBOOK.md`. That file has the complete workflow.
+
+## Claude-specific
+
+When generating HTML pages (home, subpages, showcase), use the `/frontend-design` skill for high-quality, production-grade output.

Dockerfile

@@ -0,0 +1,42 @@
+FROM node:20-slim
+
+# Chromium + dependencies (same as docker/analyzer, proven to work)
+RUN apt-get update && apt-get install -y \
+    chromium \
+    fonts-liberation \
+    fonts-noto-color-emoji \
+    libatk-bridge2.0-0 \
+    libatk1.0-0 \
+    libcups2 \
+    libdrm2 \
+    libgbm1 \
+    libnss3 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxrandr2 \
+    --no-install-recommends \
+    && rm -rf /var/lib/apt/lists/*
+
+# Docker CLI (needed for shell scripts that call other Docker containers)
+RUN apt-get update && apt-get install -y \
+    ca-certificates curl gnupg \
+    && install -m 0755 -d /etc/apt/keyrings \
+    && curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg \
+    && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian bookworm stable" > /etc/apt/sources.list.d/docker.list \
+    && apt-get update && apt-get install -y docker-ce-cli \
+    && rm -rf /var/lib/apt/lists/*
+
+# Puppeteer uses system Chromium
+ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
+ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
+ENV CHROME_PATH=/usr/bin/chromium
+
+WORKDIR /app
+
+# Install Node dependencies (scripts are mounted, not copied)
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev
+
+# Default: run a command passed as arguments
+ENTRYPOINT []
+CMD ["bash"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Enrique Lopez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.