feat: initial setup

Author: albanm

.claude/settings.json

@@ -0,0 +1,33 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash",
+      "Edit",
+      "Write",
+      "NotebookEdit",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "WebFetch(domain:vite.dev)",
+      "WebSearch",
+      "mcp__*",
+      "mcp__vuetify__get_v4_breaking_changes",
+      "mcp__vuetify__get_component_api_by_version",
+      "mcp__playwright-test__browser_navigate",
+      "mcp__playwright-test__browser_open",
+      "mcp__playwright-test__generator_setup_page",
+      "mcp__plugin_context7_context7__resolve-library-id",
+      "mcp__plugin_context7_context7__query-docs"
+    ],
+    "deny": []
+  },
+  "enabledMcpjsonServers": [
+    "playwright-test"
+  ],
+  "enabledPlugins": {
+    "superpowers@claude-plugins-official": true
+  },
+  "sandbox": {
+    "enabled": true,
+    "autoAllowBashIfSandboxed": true
+  }
+}

.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dev/logs/
+dev/data/
+.env
+test-results/

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no-install commitlint --edit ""

.husky/pre-commit

@@ -0,0 +1 @@
+npm run lint

.husky/pre-push

@@ -0,0 +1 @@
+npm run quality

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

Dockerfile

@@ -0,0 +1,26 @@
+##########################
+FROM node:24.13.0-alpine3.23 AS base
+
+WORKDIR /app
+ENV NODE_ENV=production
+
+##########################
+FROM base AS deps
+
+RUN apk add --no-cache python3 make g++ git
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev --omit=optional --no-audit --no-fund
+
+##########################
+FROM base AS main
+
+COPY --from=deps /app/node_modules node_modules
+COPY src src
+COPY package.json README.md* LICENSE ./
+
+EXPOSE 8080
+EXPOSE 9090
+
+USER node
+
+CMD ["node", "src/index.ts"]

commitlint.config.js

@@ -0,0 +1,3 @@
+export default {
+  extends: ['@commitlint/config-conventional']
+}

dev/init-env.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+RANDOM_NB=$((1024 + RANDOM % 48000))
+echo "Use random base port $RANDOM_NB"
+
+cat <<EOF > ".env"
+DEV_PORT=$((RANDOM_NB))
+MONGO_PORT=$((RANDOM_NB + 10))
+REGISTRY_PORT=$((RANDOM_NB + 20))
+
+REGISTRY_URL=http://localhost:$((RANDOM_NB + 20))
+REGISTRY_SECRET=dev-secret
+DATA_DIR=./dev/data
+PORT=$((RANDOM_NB))
+LOG_LEVEL=debug
+OBSERVER_ACTIVE=false
+EOF

docker-compose.yml

@@ -0,0 +1,24 @@
+services:
+  mongo:
+    image: mongo:8.0.17
+    command: ["mongod", "--quiet"]
+    ports:
+      - ${MONGO_PORT}:27017
+    volumes:
+      - mongo-data:/data/db
+
+  # data-fair/registry instance used as the source of tilesets and styles in dev.
+  # Point tileserver at http://localhost:${REGISTRY_PORT} via REGISTRY_URL.
+  registry:
+    image: ghcr.io/data-fair/registry:main
+    network_mode: host
+    depends_on:
+      - mongo
+    environment:
+      PORT: ${REGISTRY_PORT}
+      MONGO_URL: mongodb://localhost:${MONGO_PORT}/registry
+      OBSERVER_ACTIVE: "false"
+      SECRET_KEYS_INTERNAL_SERVICES: ${REGISTRY_SECRET}
+
+volumes:
+  mongo-data: