create-pxlr 1.0.0

package/templates/blog/pxlr-cms/README.md

@@ -0,0 +1,188 @@
+# PXLR CMS
+
+Self-hosted Headless CMS inspired by Sanity. Full control over your content management with Docker deployment.
+
+## Features
+
+- **Schema-driven content** - Define content types in code (TypeScript)
+- **Rich text editing** - TipTap-based editor with full formatting support
+- **Media library** - S3-compatible storage with image optimization
+- **Content versioning** - Full version history with diff and rollback
+- **Real-time collaboration** - WebSocket-based presence and updates
+- **Multi-language support** - Built-in i18n for localized content
+- **REST API** - Full CRUD API with Swagger documentation
+- **Modern UI** - React/Next.js admin panel with dark mode
+
+## Quick Start
+
+### Prerequisites
+
+- Docker & Docker Compose
+- Node.js 20+ (for local development)
+
+### Start with Docker
+
+```bash
+cd pxlr-cms
+
+# Start all services
+docker-compose up -d
+
+# Wait for services to initialize (~30 seconds)
+```
+
+### Access
+
+- **Admin Panel**: http://localhost:3000
+- **API**: http://localhost:4000
+- **API Docs**: http://localhost:4000/docs
+- **MinIO Console**: http://localhost:9001
+
+### Default Credentials
+
+- **Admin**: admin@pxlr.local / admin123
+- **MinIO**: pxlr_minio / pxlr_minio_secret_2024
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│                    Docker Network                    │
+├─────────────────────────────────────────────────────┤
+│                                                     │
+│  ┌─────────────┐   ┌─────────────┐   ┌──────────┐ │
+│  │   Admin     │   │    API      │   │  MinIO   │ │
+│  │  (Next.js)  │──▶│  (Fastify)  │──▶│   (S3)   │ │
+│  │  :3000      │   │   :4000     │   │  :9000   │ │
+│  └─────────────┘   └──────┬──────┘   └──────────┘ │
+│                           │                        │
+│                    ┌──────▼──────┐                 │
+│                    │             │                 │
+│              ┌─────┴─────┐ ┌─────┴─────┐          │
+│              │ PostgreSQL│ │   Redis   │          │
+│              │   :5432   │ │   :6379   │          │
+│              └───────────┘ └───────────┘          │
+│                                                     │
+└─────────────────────────────────────────────────────┘
+```
+
+## Project Structure
+
+```
+pxlr-cms/
+├── docker-compose.yml      # Docker services configuration
+├── nginx/                  # Nginx reverse proxy config
+├── packages/
+│   ├── api/               # Backend API (Fastify + TypeScript)
+│   │   ├── src/
+│   │   │   ├── modules/   # API modules (auth, content, schema, media)
+│   │   │   ├── database/  # Database connection and queries
+│   │   │   └── index.ts   # Entry point
+│   │   └── Dockerfile
+│   │
+│   ├── admin/             # Admin Panel (Next.js)
+│   │   ├── src/
+│   │   │   ├── app/       # Next.js app router pages
+│   │   │   ├── components/# React components
+│   │   │   └── lib/       # Utilities and stores
+│   │   └── Dockerfile
+│   │
+│   └── shared/            # Shared TypeScript types
+│       └── src/types/
+```
+
+## API Endpoints
+
+### Authentication
+- `POST /auth/login` - Login
+- `POST /auth/register` - Register new user
+- `GET /auth/me` - Get current user
+- `POST /auth/logout` - Logout
+
+### Schemas
+- `GET /schemas` - List all schemas
+- `GET /schemas/:name` - Get schema by name
+- `POST /schemas` - Create schema
+- `PUT /schemas/:name` - Update schema
+- `DELETE /schemas/:name` - Delete schema
+
+### Content
+- `GET /content` - List documents (with filtering)
+- `GET /content/:id` - Get document
+- `POST /content` - Create document
+- `PUT /content/:id` - Update document
+- `DELETE /content/:id` - Delete document
+- `GET /content/:id/versions` - Get version history
+- `POST /content/:id/versions/:version/restore` - Restore version
+
+### Media
+- `GET /media` - List media files
+- `GET /media/:id` - Get file
+- `POST /media/upload` - Upload file
+- `PUT /media/:id` - Update metadata
+- `DELETE /media/:id` - Delete file
+
+## Local Development
+
+### API Development
+
+```bash
+cd packages/api
+npm install
+npm run dev
+```
+
+### Admin Development
+
+```bash
+cd packages/admin
+npm install
+npm run dev
+```
+
+## Environment Variables
+
+### API (.env)
+```env
+NODE_ENV=development
+PORT=4000
+DATABASE_URL=postgresql://pxlr:pxlr_secret_2024@localhost:5432/pxlr_cms
+REDIS_URL=redis://localhost:6379
+MINIO_ENDPOINT=localhost
+MINIO_PORT=9000
+MINIO_ACCESS_KEY=pxlr_minio
+MINIO_SECRET_KEY=pxlr_minio_secret_2024
+MINIO_BUCKET=pxlr-media
+JWT_SECRET=your_jwt_secret_here
+JWT_EXPIRES_IN=7d
+```
+
+### Admin (.env.local)
+```env
+NEXT_PUBLIC_API_URL=http://localhost:4000
+NEXT_PUBLIC_WS_URL=ws://localhost:4000
+```
+
+## Production Deployment
+
+1. Update environment variables with secure values
+2. Enable Nginx profile in docker-compose:
+   ```bash
+   docker-compose --profile production up -d
+   ```
+3. Configure SSL/TLS certificates
+4. Set up backups for PostgreSQL and MinIO
+
+## Technology Stack
+
+- **Backend**: Node.js, Fastify, TypeScript
+- **Frontend**: Next.js 15, React 19, TailwindCSS
+- **Database**: PostgreSQL 16
+- **Cache**: Redis 7
+- **Storage**: MinIO (S3-compatible)
+- **Editor**: TipTap
+- **State**: Zustand, React Query
+
+## License
+
+MIT License

package/templates/blog/pxlr-cms/docker-compose.yml

@@ -0,0 +1,132 @@
+services:
+  # PostgreSQL Database
+  postgres:
+    image: postgres:16-alpine
+    container_name: pxlr-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: pxlr
+      POSTGRES_PASSWORD: pxlr_secret_2024
+      POSTGRES_DB: pxlr_cms
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./packages/api/src/database/init.sql:/docker-entrypoint-initdb.d/init.sql
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U pxlr -d pxlr_cms"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # Redis for caching and pub/sub
+  redis:
+    image: redis:7-alpine
+    container_name: pxlr-redis
+    restart: unless-stopped
+    command: redis-server --appendonly yes
+    volumes:
+      - redis_data:/data
+    ports:
+      - "6379:6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # MinIO S3-compatible storage for media
+  minio:
+    image: minio/minio:latest
+    container_name: pxlr-minio
+    restart: unless-stopped
+    command: server /data --console-address ":9011"
+    environment:
+      MINIO_ROOT_USER: pxlr_minio
+      MINIO_ROOT_PASSWORD: pxlr_minio_secret_2024
+    volumes:
+      - minio_data:/data
+    ports:
+      - "9010:9000"
+      - "9011:9011"
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+      interval: 30s
+      timeout: 20s
+      retries: 3
+
+  # Backend API
+  api:
+    build:
+      context: ./packages/api
+      dockerfile: Dockerfile
+    container_name: pxlr-api
+    restart: unless-stopped
+    environment:
+      NODE_ENV: development
+      PORT: 4000
+      DATABASE_URL: postgresql://pxlr:pxlr_secret_2024@postgres:5432/pxlr_cms
+      REDIS_URL: redis://redis:6379
+      MINIO_ENDPOINT: minio
+      MINIO_PORT: "9000"
+      MINIO_ACCESS_KEY: pxlr_minio
+      MINIO_SECRET_KEY: pxlr_minio_secret_2024
+      MINIO_BUCKET: pxlr-media
+      JWT_SECRET: pxlr_jwt_secret_change_in_production_2024
+      JWT_EXPIRES_IN: 7d
+    ports:
+      - "4000:4000"
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+      minio:
+        condition: service_healthy
+    volumes:
+      - ./packages/api:/app
+      - /app/node_modules
+
+  # Admin Panel
+  admin:
+    build:
+      context: ./packages/admin
+      dockerfile: Dockerfile
+    container_name: pxlr-admin
+    restart: unless-stopped
+    environment:
+      NODE_ENV: development
+      NEXT_PUBLIC_API_URL: http://localhost:4000
+      NEXT_PUBLIC_WS_URL: ws://localhost:4000
+    ports:
+      - "3333:3000"
+    depends_on:
+      - api
+    volumes:
+      - ./packages/admin:/app
+      - /app/node_modules
+      - /app/.next
+
+  # Nginx reverse proxy (for production)
+  nginx:
+    image: nginx:alpine
+    container_name: pxlr-nginx
+    restart: unless-stopped
+    ports:
+      - "80:80"
+    volumes:
+      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
+    depends_on:
+      - api
+      - admin
+    profiles:
+      - production
+
+volumes:
+  postgres_data:
+  redis_data:
+  minio_data:
+
+networks:
+  default:
+    name: pxlr-network

package/templates/blog/pxlr-cms/nginx/nginx.conf

@@ -0,0 +1,107 @@
+events {
+    worker_connections 1024;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    # Logging
+    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                    '$status $body_bytes_sent "$http_referer" '
+                    '"$http_user_agent" "$http_x_forwarded_for"';
+
+    access_log /var/log/nginx/access.log main;
+    error_log /var/log/nginx/error.log warn;
+
+    # Performance
+    sendfile on;
+    tcp_nopush on;
+    tcp_nodelay on;
+    keepalive_timeout 65;
+    types_hash_max_size 2048;
+
+    # Gzip compression
+    gzip on;
+    gzip_vary on;
+    gzip_proxied any;
+    gzip_comp_level 6;
+    gzip_types text/plain text/css text/xml application/json application/javascript 
+               application/xml application/xml+rss text/javascript application/x-javascript;
+
+    # Rate limiting
+    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
+
+    # Upstream servers
+    upstream api_backend {
+        server api:4000;
+        keepalive 32;
+    }
+
+    upstream admin_frontend {
+        server admin:3000;
+        keepalive 32;
+    }
+
+    server {
+        listen 80;
+        server_name localhost;
+
+        # Security headers
+        add_header X-Frame-Options "SAMEORIGIN" always;
+        add_header X-Content-Type-Options "nosniff" always;
+        add_header X-XSS-Protection "1; mode=block" always;
+        add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+
+        # Max upload size
+        client_max_body_size 100M;
+
+        # API routes
+        location /api/ {
+            limit_req zone=api_limit burst=20 nodelay;
+            
+            proxy_pass http://api_backend/;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_cache_bypass $http_upgrade;
+            proxy_read_timeout 300s;
+            proxy_connect_timeout 75s;
+        }
+
+        # WebSocket for real-time
+        location /ws/ {
+            proxy_pass http://api_backend/ws/;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_read_timeout 86400s;
+        }
+
+        # Admin panel (default)
+        location / {
+            proxy_pass http://admin_frontend;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+        }
+
+        # Health check endpoint
+        location /health {
+            access_log off;
+            return 200 "OK";
+            add_header Content-Type text/plain;
+        }
+    }
+}

package/templates/blog/pxlr-cms/packages/admin/.dockerignore

@@ -0,0 +1,4 @@
+node_modules
+.next
+.git
+*.log

package/templates/blog/pxlr-cms/packages/admin/.env.example

@@ -0,0 +1,2 @@
+NEXT_PUBLIC_API_URL=http://localhost:4000
+NEXT_PUBLIC_WS_URL=ws://localhost:4000

package/templates/blog/pxlr-cms/packages/admin/Dockerfile

@@ -0,0 +1,19 @@
+# PXLR CMS Admin Panel Dockerfile
+FROM node:20-alpine
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json ./
+
+# Install dependencies
+RUN npm cache clean --force && npm install --legacy-peer-deps
+
+# Copy source code
+COPY . .
+
+# Expose port
+EXPOSE 3000
+
+# Start development server
+CMD ["npm", "run", "dev"]

package/templates/blog/pxlr-cms/packages/admin/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+/// <reference path="./.next/types/routes.d.ts" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/templates/blog/pxlr-cms/packages/admin/next.config.ts

@@ -0,0 +1,22 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  devIndicators: false,
+  output: 'standalone',
+  images: {
+    remotePatterns: [
+      {
+        protocol: 'http',
+        hostname: 'localhost',
+        port: '9000',
+      },
+      {
+        protocol: 'http',
+        hostname: 'minio',
+        port: '9000',
+      },
+    ],
+  },
+};
+
+export default nextConfig;

package/templates/blog/pxlr-cms/packages/admin/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@pxlr/admin",
+  "version": "1.0.0",
+  "description": "PXLR CMS Admin Panel",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^3.9.0",
+    "@radix-ui/react-alert-dialog": "^1.1.2",
+    "@radix-ui/react-avatar": "^1.1.1",
+    "@radix-ui/react-dialog": "^1.1.2",
+    "@radix-ui/react-dropdown-menu": "^2.1.2",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-select": "^2.1.2",
+    "@radix-ui/react-separator": "^1.1.0",
+    "@radix-ui/react-slot": "^1.1.0",
+    "@radix-ui/react-tabs": "^1.1.1",
+    "@radix-ui/react-toast": "^1.2.2",
+    "@radix-ui/react-tooltip": "^1.1.3",
+    "@tanstack/react-query": "^5.59.0",
+    "@tiptap/extension-color": "^2.10.0",
+    "@tiptap/extension-highlight": "^2.10.0",
+    "@tiptap/extension-image": "^2.10.0",
+    "@tiptap/extension-link": "^2.10.0",
+    "@tiptap/extension-placeholder": "^2.10.0",
+    "@tiptap/extension-text-align": "^2.10.0",
+    "@tiptap/extension-text-style": "^2.10.0",
+    "@tiptap/extension-underline": "^2.10.0",
+    "@tiptap/pm": "^2.10.0",
+    "@tiptap/react": "^2.10.0",
+    "@tiptap/starter-kit": "^2.10.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.1",
+    "date-fns": "^4.1.0",
+    "lucide-react": "^0.453.0",
+    "next": "^15.1.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-dropzone": "^14.2.9",
+    "react-hook-form": "^7.53.0",
+    "socket.io-client": "^4.8.0",
+    "tailwind-merge": "^2.5.3",
+    "tailwindcss-animate": "^1.0.7",
+    "zod": "^3.23.8",
+    "zustand": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "^15.1.0",
+    "postcss": "^8.4.47",
+    "tailwindcss": "^3.4.14",
+    "typescript": "^5.6.0"
+  }
+}