Setup Podman and Podman Compose for local development

Add comprehensive Podman configuration for local development:

- docker-compose.yml: Main compose file with all services (PostgreSQL, RabbitMQ, API, Frontend)
- docker-compose.dev.yml: Development-specific overrides with hot-reload
- Dockerfile.api: Backend API service Dockerfile
- Dockerfile.frontend: Frontend Next.js service Dockerfile
- Updated Dockerfile: Podman-compatible production build with better layer caching
- .env.example: Environment variable template
- .dockerignore: Exclude unnecessary files from builds
- Makefile: Convenient commands for common Podman operations
- scripts/db/: Database initialization scripts directory
- Updated README.md: Comprehensive Podman setup and usage documentation

Features:
- Rootless Podman support with SELinux compatibility
- Development mode with volume mounts for hot-reload
- Health checks for service dependencies
- Proper build stage optimization
- All services networked together

.dockerignore

@@ -0,0 +1,46 @@
+# Dependencies
+node_modules
+**/node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Build outputs
+.next
+.turbo
+dist
+build
+out
+*.log
+
+# Environment files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Git
+.git
+.gitignore
+.gitattributes
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+coverage
+.nyc_output
+
+# Misc
+*.md
+!README.md
+.editorconfig
+.prettierrc
+.eslintrc*

.env.example

@@ -0,0 +1,19 @@
+# Node Environment
+NODE_ENV=development
+
+# PostgreSQL Configuration
+POSTGRES_USER=lightsaver
+POSTGRES_PASSWORD=lightsaver_dev
+POSTGRES_DB=lightsaver
+DATABASE_URL=postgresql://lightsaver:lightsaver_dev@localhost:5432/lightsaver
+
+# RabbitMQ Configuration
+RABBITMQ_USER=lightsaver
+RABBITMQ_PASSWORD=lightsaver_dev
+RABBITMQ_URL=amqp://lightsaver:lightsaver_dev@localhost:5672
+
+# API Configuration
+API_PORT=4000
+
+# Frontend Configuration
+NEXT_PUBLIC_API_URL=http://localhost:4000/graphql

.gitignore

@@ -1 +1,3 @@
 node_modules
+.turbo
+out

Dockerfile

@@ -0,0 +1,50 @@
+# Production Build - Podman Compatible
+# 1. Build stage
+FROM docker.io/library/node:22-slim AS builder
+
+ENV NVM_DIR=/root/.nvm
+ENV NODE_VERSION=22
+
+# Install dependencies for Node
+RUN apt-get update && \
+    apt-get dist-upgrade -y && \
+    apt-get install -y ca-certificates build-essential && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# Enable corepack and prepare pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+WORKDIR /app
+
+# Copy package files first for better layer caching
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml turbo.json ./
+COPY apps/lightsaver_user_client/package.json ./apps/lightsaver_user_client/
+COPY packages ./packages
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy source code
+COPY apps/lightsaver_user_client ./apps/lightsaver_user_client
+
+# Build the application
+RUN pnpm turbo run build --filter=lightsaver_user_client...
+
+# 2. Production stage
+FROM docker.io/library/node:22-slim
+
+WORKDIR /app
+
+# Copy built application and dependencies
+COPY --from=builder /app/apps/lightsaver_user_client/.next ./apps/lightsaver_user_client/.next
+COPY --from=builder /app/apps/lightsaver_user_client/public ./apps/lightsaver_user_client/public
+COPY --from=builder /app/apps/lightsaver_user_client/package.json ./apps/lightsaver_user_client/
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/packages ./packages
+COPY --from=builder /app/package.json ./
+
+EXPOSE 3000
+
+# Run the production server
+CMD ["node_modules/.bin/next", "start", "apps/lightsaver_user_client"]

Dockerfile.api

@@ -0,0 +1,35 @@
+# Backend API Dockerfile for Podman
+FROM docker.io/library/node:22-slim
+
+# Install required dependencies
+RUN apt-get update && \
+    apt-get dist-upgrade -y && \
+    apt-get install -y ca-certificates build-essential && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# Enable corepack and prepare pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY turbo.json ./
+
+# Copy service and package directories
+COPY services/package.json ./services/
+COPY packages ./packages
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy service source code
+COPY services ./services
+
+# Expose API port
+EXPOSE 4000
+
+# Default command (can be overridden in docker-compose)
+CMD ["pnpm", "--filter", "api", "dev"]

Dockerfile.frontend

@@ -0,0 +1,35 @@
+# Frontend Dockerfile for Podman
+FROM docker.io/library/node:22-slim
+
+# Install required dependencies
+RUN apt-get update && \
+    apt-get dist-upgrade -y && \
+    apt-get install -y ca-certificates build-essential && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# Enable corepack and prepare pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY turbo.json ./
+
+# Copy app and package directories
+COPY apps/lightsaver_user_client/package.json ./apps/lightsaver_user_client/
+COPY packages ./packages
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy app source code
+COPY apps/lightsaver_user_client ./apps/lightsaver_user_client
+
+# Expose Next.js port
+EXPOSE 3000
+
+# Default command (can be overridden in docker-compose)
+CMD ["pnpm", "--filter", "lightsaver_user_client", "dev", "--", "--turbopack"]

Makefile

@@ -0,0 +1,93 @@
+.PHONY: help dev up down build rebuild logs clean install test
+
+# Default target
+help:
+	@echo "LightSaver - Podman Development Commands"
+	@echo ""
+	@echo "Available targets:"
+	@echo "  make dev        - Start all services in development mode with hot-reload"
+	@echo "  make up         - Start all services in detached mode"
+	@echo "  make down       - Stop all services"
+	@echo "  make build      - Build all service images"
+	@echo "  make rebuild    - Rebuild and restart all services"
+	@echo "  make logs       - Follow logs from all services"
+	@echo "  make logs-api   - Follow logs from API service"
+	@echo "  make logs-fe    - Follow logs from frontend service"
+	@echo "  make clean      - Stop services and remove volumes"
+	@echo "  make install    - Install dependencies in running containers"
+	@echo "  make shell-api  - Open shell in API container"
+	@echo "  make shell-fe   - Open shell in frontend container"
+	@echo "  make db-shell   - Open PostgreSQL shell"
+	@echo "  make setup      - Initial setup (copy .env, install deps)"
+
+# Start services in development mode with hot-reload
+dev:
+	podman-compose -f docker-compose.yml -f docker-compose.dev.yml up
+
+# Start services in detached mode
+up:
+	podman-compose up -d
+
+# Stop all services
+down:
+	podman-compose down
+
+# Build all images
+build:
+	podman-compose build
+
+# Rebuild and restart
+rebuild:
+	podman-compose down
+	podman-compose build
+	podman-compose up -d
+
+# View logs
+logs:
+	podman-compose logs -f
+
+logs-api:
+	podman-compose logs -f api
+
+logs-fe:
+	podman-compose logs -f frontend
+
+logs-db:
+	podman-compose logs -f postgres
+
+logs-mq:
+	podman-compose logs -f rabbitmq
+
+# Stop and remove everything including volumes
+clean:
+	podman-compose down -v
+	@echo "Cleaned up all containers and volumes"
+
+# Install dependencies
+install:
+	podman-compose exec frontend pnpm install
+	podman-compose exec api pnpm install
+
+# Open shells
+shell-api:
+	podman-compose exec api sh
+
+shell-fe:
+	podman-compose exec frontend sh
+
+# Database shell
+db-shell:
+	podman-compose exec postgres psql -U lightsaver -d lightsaver
+
+# Initial setup
+setup:
+	@if [ ! -f .env ]; then cp .env.example .env; echo "Created .env file"; fi
+	@echo "Setup complete! Run 'make dev' to start development"
+
+# Production build
+prod-build:
+	podman build -t lightsaver-app .
+
+# Run production container
+prod-run:
+	podman run -p 3000:3000 lightsaver-app

README.md

@@ -0,0 +1,127 @@
+# LightSaver
+
+## Technologies Used
+
+- **Next.js**: React-based framework for building server-side rendered and statically generated web applications.
+- **GraphQL**: API query language for flexible and efficient data fetching.
+- **Express.js**: Fast, unopinionated web framework for Node.js, powering the backend API.
+- **PostgreSQL**: Relational database for persistent storage.
+- **Podman & Podman Compose**: Container orchestration for local development and deployment.
+- **Terraform CDKTF**: Infrastructure as Code (IaC) using the Cloud Development Kit for Terraform.
+- **RabbitMQ**: Message broker for asynchronous communication and background processing.
+
+## Prerequisites
+
+- **Podman**: Install from [podman.io](https://podman.io/getting-started/installation)
+- **Podman Compose**: Install via `pip install podman-compose`
+- **Node.js**: Version 22.17.0 or higher
+- **pnpm**: Package manager (installed via corepack)
+
+## Local Development with Podman
+
+### Quick Start
+
+1. **Clone the repository**
+   ```sh
+   git clone <repository-url>
+   cd lightsaver
+   ```
+
+2. **Set up environment variables**
+   ```sh
+   cp .env.example .env
+   # Edit .env with your configuration if needed
+   ```
+
+3. **Start all services with Podman Compose**
+   ```sh
+   # Development mode with hot-reload
+   podman-compose -f docker-compose.yml -f docker-compose.dev.yml up
+
+   # Or use the base configuration only
+   podman-compose up
+   ```
+
+4. **Access the applications**
+   - Frontend: http://localhost:3000
+   - Backend API: http://localhost:4000
+   - RabbitMQ Management: http://localhost:15672 (user: lightsaver, password: lightsaver_dev)
+   - PostgreSQL: localhost:5432
+
+### Available Podman Commands
+
+**Start services in detached mode:**
+```sh
+podman-compose up -d
+```
+
+**Stop services:**
+```sh
+podman-compose down
+```
+
+**Stop services and remove volumes:**
+```sh
+podman-compose down -v
+```
+
+**View logs:**
+```sh
+# All services
+podman-compose logs -f
+
+# Specific service
+podman-compose logs -f frontend
+podman-compose logs -f api
+```
+
+**Rebuild services:**
+```sh
+podman-compose build
+podman-compose up --build
+```
+
+**Run commands in a service container:**
+```sh
+# Frontend
+podman-compose exec frontend pnpm install
+podman-compose exec frontend pnpm build
+
+# API
+podman-compose exec api pnpm install
+```
+
+### Production Build
+
+Build the production image:
+```sh
+podman build -t lightsaver-app .
+```
+
+Run the production container:
+```sh
+podman run -p 3000:3000 lightsaver-app
+```
+
+### Service Architecture
+
+The project uses the following services:
+
+- **frontend**: Next.js application (port 3000)
+- **api**: Express + GraphQL API (port 4000)
+- **postgres**: PostgreSQL database (port 5432)
+- **rabbitmq**: RabbitMQ message broker (ports 5672, 15672)
+
+### Troubleshooting
+
+**Port conflicts:**
+If ports are already in use, modify the port mappings in `docker-compose.yml`.
+
+**Permission issues with volumes:**
+Podman runs rootless by default. Add `:z` or `:Z` to volume mounts if you encounter permission issues.
+
+**SELinux issues:**
+The dev compose file includes `:z` flags for volume mounts to handle SELinux contexts.
+
+**Container doesn't start:**
+Check logs with `podman-compose logs <service-name>` to diagnose issues.

apps/lightsaver_user_client/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "web",
+  "name": "lightsaver_user_client",
   "version": "0.1.0",
   "private": true,
   "scripts": {
@@ -9,19 +9,21 @@
     "lint": "next lint"
   },
   "dependencies": {
+    "@apollo/client": "^3.13.8",
+    "graphql": "^16.11.0",
+    "next": "15.3.5",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "next": "15.3.5"
+    "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "typescript": "^5",
+    "@eslint/eslintrc": "^3",
+    "@tailwindcss/postcss": "^4",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "@tailwindcss/postcss": "^4",
-    "tailwindcss": "^4",
     "eslint": "^9",
     "eslint-config-next": "15.3.5",
-    "@eslint/eslintrc": "^3"
+    "tailwindcss": "^4",
+    "typescript": "^5"
   }
 }

docker-compose.dev.yml

@@ -0,0 +1,61 @@
+version: '3.8'
+
+# Development-specific configuration
+# Usage: podman-compose -f docker-compose.yml -f docker-compose.dev.yml up
+
+services:
+  postgres:
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      # Add local SQL scripts for development
+      - ./scripts/db:/docker-entrypoint-initdb.d
+
+  rabbitmq:
+    ports:
+      - "5672:5672"
+      - "15672:15672"
+    volumes:
+      - rabbitmq_data:/var/lib/rabbitmq
+
+  api:
+    build:
+      target: builder
+    environment:
+      NODE_ENV: development
+      DEBUG: "api:*"
+    volumes:
+      # Enable hot-reload for development
+      - ./services:/app/services:z
+      - ./packages:/app/packages:z
+      # Prevent overwriting node_modules
+      - /app/node_modules
+      - /app/services/node_modules
+    stdin_open: true
+    tty: true
+
+  frontend:
+    build:
+      target: builder
+    environment:
+      NODE_ENV: development
+      NEXT_TELEMETRY_DISABLED: 1
+    volumes:
+      # Enable hot-reload for development
+      - ./apps/lightsaver_user_client:/app/apps/lightsaver_user_client:z
+      - ./packages:/app/packages:z
+      # Prevent overwriting node_modules and build artifacts
+      - /app/node_modules
+      - /app/apps/lightsaver_user_client/node_modules
+      - /app/apps/lightsaver_user_client/.next
+    stdin_open: true
+    tty: true
+
+volumes:
+  postgres_data:
+  rabbitmq_data:
+
+networks:
+  lightsaver-network:
+    driver: bridge

docker-compose.yml

@@ -0,0 +1,100 @@
+version: '3.8'
+
+services:
+  # PostgreSQL Database
+  postgres:
+    image: docker.io/library/postgres:16-alpine
+    container_name: lightsaver-postgres
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-lightsaver}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-lightsaver_dev}
+      POSTGRES_DB: ${POSTGRES_DB:-lightsaver}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-lightsaver}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - lightsaver-network
+
+  # RabbitMQ Message Broker
+  rabbitmq:
+    image: docker.io/library/rabbitmq:3-management-alpine
+    container_name: lightsaver-rabbitmq
+    environment:
+      RABBITMQ_DEFAULT_USER: ${RABBITMQ_USER:-lightsaver}
+      RABBITMQ_DEFAULT_PASS: ${RABBITMQ_PASSWORD:-lightsaver_dev}
+    ports:
+      - "5672:5672"   # AMQP port
+      - "15672:15672" # Management UI
+    volumes:
+      - rabbitmq_data:/var/lib/rabbitmq
+    healthcheck:
+      test: ["CMD", "rabbitmq-diagnostics", "ping"]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+    networks:
+      - lightsaver-network
+
+  # Backend API Service
+  api:
+    build:
+      context: .
+      dockerfile: Dockerfile.api
+    container_name: lightsaver-api
+    environment:
+      NODE_ENV: ${NODE_ENV:-development}
+      PORT: ${API_PORT:-4000}
+      DATABASE_URL: postgresql://${POSTGRES_USER:-lightsaver}:${POSTGRES_PASSWORD:-lightsaver_dev}@postgres:5432/${POSTGRES_DB:-lightsaver}
+      RABBITMQ_URL: amqp://${RABBITMQ_USER:-lightsaver}:${RABBITMQ_PASSWORD:-lightsaver_dev}@rabbitmq:5672
+    ports:
+      - "4000:4000"
+    volumes:
+      - ./services:/app/services
+      - ./packages:/app/packages
+      - /app/node_modules
+      - /app/services/node_modules
+    depends_on:
+      postgres:
+        condition: service_healthy
+      rabbitmq:
+        condition: service_healthy
+    networks:
+      - lightsaver-network
+    command: sh -c "cd /app && pnpm install && pnpm --filter api dev"
+
+  # Frontend Next.js Application
+  frontend:
+    build:
+      context: .
+      dockerfile: Dockerfile.frontend
+    container_name: lightsaver-frontend
+    environment:
+      NODE_ENV: ${NODE_ENV:-development}
+      NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL:-http://localhost:4000/graphql}
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./apps/lightsaver_user_client:/app/apps/lightsaver_user_client
+      - ./packages:/app/packages
+      - /app/node_modules
+      - /app/apps/lightsaver_user_client/node_modules
+      - /app/apps/lightsaver_user_client/.next
+    depends_on:
+      - api
+    networks:
+      - lightsaver-network
+    command: sh -c "cd /app && pnpm install && pnpm --filter lightsaver_user_client dev"
+
+networks:
+  lightsaver-network:
+    driver: bridge
+
+volumes:
+  postgres_data:
+  rabbitmq_data:

package.json

@@ -4,8 +4,10 @@
   "description": "",
   "main": "index.js",
   "scripts": {
+    "build": "turbo run build",
+    "check-types": "tsc --noEmit",
     "test": "echo \"Error: no test specified\" && exit 1"
-  },
+  }, 
   "keywords": [],
   "author": "Jason Ross",
   "license": "ISC",
@@ -17,6 +19,8 @@
     "lightsaver": "workspace:*"
   },
   "devDependencies": {
-    "pnpm": "^10.13.1"
+    "pnpm": "^10.13.1",
+    "turbo": "^2.5.4",
+    "typescript": "^5.8.3"
   }
 }

pnpm-lock.yaml

@@ -15,9 +15,21 @@ importers:
       pnpm:
         specifier: ^10.13.1
         version: 10.13.1
+      turbo:
+        specifier: ^2.5.4
+        version: 2.5.4
+      typescript:
+        specifier: ^5.8.3
+        version: 5.8.3
 
-  apps/web:
+  apps/lightsaver_user_client:
     dependencies:
+      '@apollo/client':
+        specifier: ^3.13.8
+        version: 3.13.8(@types/react@19.1.8)(graphql@16.11.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0)
+      graphql:
+        specifier: ^16.11.0
+        version: 16.11.0
       next:
         specifier: 15.3.5
         version: 15.3.5(react-dom@19.1.0(react@19.1.0))(react@19.1.0)
@@ -66,6 +78,24 @@ packages:
     resolution: {integrity: sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==}
     engines: {node: '>=6.0.0'}
 
+  '@apollo/client@3.13.8':
+    resolution: {integrity: sha512-YM9lQpm0VfVco4DSyKooHS/fDTiKQcCHfxr7i3iL6a0kP/jNO5+4NFK6vtRDxaYisd5BrwOZHLJpPBnvRVpKPg==}
+    peerDependencies:
+      graphql: ^15.0.0 || ^16.0.0
+      graphql-ws: ^5.5.5 || ^6.0.3
+      react: ^16.8.0 || ^17.0.0 || ^18.0.0 || >=19.0.0-rc
+      react-dom: ^16.8.0 || ^17.0.0 || ^18.0.0 || >=19.0.0-rc
+      subscriptions-transport-ws: ^0.9.0 || ^0.11.0
+    peerDependenciesMeta:
+      graphql-ws:
+        optional: true
+      react:
+        optional: true
+      react-dom:
+        optional: true
+      subscriptions-transport-ws:
+        optional: true
+
   '@emnapi/core@1.4.4':
     resolution: {integrity: sha512-A9CnAbC6ARNMKcIcrQwq6HeHCjpcBZ5wSx4U01WXCqEKlrzB9F9315WDNHkrs2xbx7YjjSxbUYxuN6EQzpcY2g==}
 
@@ -113,6 +143,11 @@ packages:
     resolution: {integrity: sha512-1+WqvgNMhmlAambTvT3KPtCl/Ibr68VldY2XY40SL1CE0ZXiakFR/cbTspaF5HsnpDMvcYYoJHfl4980NBjGag==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
+  '@graphql-typed-document-node/core@3.2.0':
+    resolution: {integrity: sha512-mB9oAsNCm9aM3/SOv4YtBMqZbYj10R7dkq8byBqxGY/ncFwhf2oQzMV+LCRlWoDSEBJ3COiR1yeDvMtsoOsuFQ==}
+    peerDependencies:
+      graphql: ^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0
+
   '@humanfs/core@0.19.1':
     resolution: {integrity: sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==}
     engines: {node: '>=18.18.0'}
@@ -622,6 +657,22 @@ packages:
     cpu: [x64]
     os: [win32]
 
+  '@wry/caches@1.0.1':
+    resolution: {integrity: sha512-bXuaUNLVVkD20wcGBWRyo7j9N3TxePEWFZj2Y+r9OoUzfqmavM84+mFykRicNsBqatba5JLay1t48wxaXaWnlA==}
+    engines: {node: '>=8'}
+
+  '@wry/context@0.7.4':
+    resolution: {integrity: sha512-jmT7Sb4ZQWI5iyu3lobQxICu2nC/vbUhP0vIdd6tHC9PTfenmRmuIFqktc6GH9cgi+ZHnsLWPvfSvc4DrYmKiQ==}
+    engines: {node: '>=8'}
+
+  '@wry/equality@0.5.7':
+    resolution: {integrity: sha512-BRFORjsTuQv5gxcXsuDXx6oGRhuVsEGwZy6LOzRRfgu+eSfxbhUQ9L9YtSEIuIjY/o7g3iWFjrc5eSY1GXP2Dw==}
+    engines: {node: '>=8'}
+
+  '@wry/trie@0.5.0':
+    resolution: {integrity: sha512-FNoYzHawTMk/6KMQoEG5O4PuioX19UbwdQKF44yw0nLfOypfQdjtfZzo/UIJWAJ23sNIFbD1Ug9lbaDGMwbqQA==}
+    engines: {node: '>=8'}
+
   acorn-jsx@5.3.2:
     resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==}
     peerDependencies:
@@ -1084,6 +1135,16 @@ packages:
   graphemer@1.4.0:
     resolution: {integrity: sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==}
 
+  graphql-tag@2.12.6:
+    resolution: {integrity: sha512-FdSNcu2QQcWnM2VNvSCCDCVS5PpPqpzgFT8+GXzqJuoDd0CBncxCY278u4mhRO7tMgo2JjgJA5aZ+nWSQ/Z+xg==}
+    engines: {node: '>=10'}
+    peerDependencies:
+      graphql: ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0
+
+  graphql@16.11.0:
+    resolution: {integrity: sha512-mS1lbMsxgQj6hge1XZ6p7GPhbrtFwUFYi3wRzXAC/FmYnyXMTvvI3td3rjmQ2u8ewXueaSvRPWaEcgVVOT9Jnw==}
+    engines: {node: ^12.22.0 || ^14.16.0 || ^16.0.0 || >=17.0.0}
+
   has-bigints@1.1.0:
     resolution: {integrity: sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==}
     engines: {node: '>= 0.4'}
@@ -1111,6 +1172,9 @@ packages:
     resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
     engines: {node: '>= 0.4'}
 
+  hoist-non-react-statics@3.3.2:
+    resolution: {integrity: sha512-/gGivxi8JPKWNm/W0jSmzcMPpfpPLc3dY/6GxhX2hQ9iGj3aDfklV4ET7NjKpSinLpJ5vafa9iiGIEZg10SfBw==}
+
   ignore@5.3.2:
     resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==}
     engines: {node: '>= 4'}
@@ -1471,6 +1535,9 @@ packages:
     resolution: {integrity: sha512-gXah6aZrcUxjWg2zR2MwouP2eHlCBzdV4pygudehaKXSGW4v2AsRQUK+lwwXhii6KFZcunEnmSUoYp5CXibxtA==}
     engines: {node: '>= 0.4'}
 
+  optimism@0.18.1:
+    resolution: {integrity: sha512-mLXNwWPa9dgFyDqkNi54sjDyNJ9/fTI6WGBLgnXku1vdKY/jovHfZT5r+aiVeFFLOz+foPNOm5YJ4mqgld2GBQ==}
+
   optionator@0.9.4:
     resolution: {integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==}
     engines: {node: '>= 0.8.0'}
@@ -1564,6 +1631,17 @@ packages:
     resolution: {integrity: sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==}
     engines: {node: '>= 0.4'}
 
+  rehackt@0.1.0:
+    resolution: {integrity: sha512-7kRDOuLHB87D/JESKxQoRwv4DzbIdwkAGQ7p6QKGdVlY1IZheUnVhlk/4UZlNUVxdAXpyxikE3URsG067ybVzw==}
+    peerDependencies:
+      '@types/react': '*'
+      react: '*'
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      react:
+        optional: true
+
   resolve-from@4.0.0:
     resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}
     engines: {node: '>=4'}
@@ -1721,6 +1799,10 @@ packages:
     resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
     engines: {node: '>= 0.4'}
 
+  symbol-observable@4.0.0:
+    resolution: {integrity: sha512-b19dMThMV4HVFynSAM1++gBHAbk2Tc/osgLIBZMKsyqh34jb2e8Os7T6ZW/Bt3pJFdBTd2JwAnAAEQV7rSNvcQ==}
+    engines: {node: '>=0.10'}
+
   tailwindcss@4.1.11:
     resolution: {integrity: sha512-2E9TBm6MDD/xKYe+dvJZAmg3yxIEDNRc0jwlNyDg/4Fil2QcSLjFKGVff0lAf1jjeaArlG/M75Ey/EYr/OJtBA==}
 
@@ -1746,12 +1828,50 @@ packages:
     peerDependencies:
       typescript: '>=4.8.4'
 
+  ts-invariant@0.10.3:
+    resolution: {integrity: sha512-uivwYcQaxAucv1CzRp2n/QdYPo4ILf9VXgH19zEIjFx2EJufV16P0JtJVpYHy89DItG6Kwj2oIUjrcK5au+4tQ==}
+    engines: {node: '>=8'}
+
   tsconfig-paths@3.15.0:
     resolution: {integrity: sha512-2Ac2RgzDe/cn48GvOe3M+o82pEFewD3UPbyoUHHdKasHwJKjds4fLXWf/Ux5kATBKN20oaFGu+jbElp1pos0mg==}
 
   tslib@2.8.1:
     resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
 
+  turbo-darwin-64@2.5.4:
+    resolution: {integrity: sha512-ah6YnH2dErojhFooxEzmvsoZQTMImaruZhFPfMKPBq8sb+hALRdvBNLqfc8NWlZq576FkfRZ/MSi4SHvVFT9PQ==}
+    cpu: [x64]
+    os: [darwin]
+
+  turbo-darwin-arm64@2.5.4:
+    resolution: {integrity: sha512-2+Nx6LAyuXw2MdXb7pxqle3MYignLvS7OwtsP9SgtSBaMlnNlxl9BovzqdYAgkUW3AsYiQMJ/wBRb7d+xemM5A==}
+    cpu: [arm64]
+    os: [darwin]
+
+  turbo-linux-64@2.5.4:
+    resolution: {integrity: sha512-5May2kjWbc8w4XxswGAl74GZ5eM4Gr6IiroqdLhXeXyfvWEdm2mFYCSWOzz0/z5cAgqyGidF1jt1qzUR8hTmOA==}
+    cpu: [x64]
+    os: [linux]
+
+  turbo-linux-arm64@2.5.4:
+    resolution: {integrity: sha512-/2yqFaS3TbfxV3P5yG2JUI79P7OUQKOUvAnx4MV9Bdz6jqHsHwc9WZPpO4QseQm+NvmgY6ICORnoVPODxGUiJg==}
+    cpu: [arm64]
+    os: [linux]
+
+  turbo-windows-64@2.5.4:
+    resolution: {integrity: sha512-EQUO4SmaCDhO6zYohxIjJpOKRN3wlfU7jMAj3CgcyTPvQR/UFLEKAYHqJOnJtymbQmiiM/ihX6c6W6Uq0yC7mA==}
+    cpu: [x64]
+    os: [win32]
+
+  turbo-windows-arm64@2.5.4:
+    resolution: {integrity: sha512-oQ8RrK1VS8lrxkLriotFq+PiF7iiGgkZtfLKF4DDKsmdbPo0O9R2mQxm7jHLuXraRCuIQDWMIw6dpcr7Iykf4A==}
+    cpu: [arm64]
+    os: [win32]
+
+  turbo@2.5.4:
+    resolution: {integrity: sha512-kc8ZibdRcuWUG1pbYSBFWqmIjynlD8Lp7IB6U3vIzvOv9VG+6Sp8bzyeBWE3Oi8XV5KsQrznyRTBPvrf99E4mA==}
+    hasBin: true
+
   type-check@0.4.0:
     resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
     engines: {node: '>= 0.8.0'}
@@ -1823,6 +1943,12 @@ packages:
     resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
     engines: {node: '>=10'}
 
+  zen-observable-ts@1.2.5:
+    resolution: {integrity: sha512-QZWQekv6iB72Naeake9hS1KxHlotfRpe+WGNbNx5/ta+R3DNjVO2bswf63gXlWDcs+EMd7XY8HfVQyP1X6T4Zg==}
+
+  zen-observable@0.8.15:
+    resolution: {integrity: sha512-PQ2PC7R9rslx84ndNBZB/Dkv8V8fZEpk83RLgXtYd0fwUgEjseMn1Dgajh2x6S8QbZAFa9p2qVCEuYZNgve0dQ==}
+
 snapshots:
 
   '@alloc/quick-lru@5.2.0': {}
@@ -1832,6 +1958,28 @@ snapshots:
       '@jridgewell/gen-mapping': 0.3.12
       '@jridgewell/trace-mapping': 0.3.29
 
+  '@apollo/client@3.13.8(@types/react@19.1.8)(graphql@16.11.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0)':
+    dependencies:
+      '@graphql-typed-document-node/core': 3.2.0(graphql@16.11.0)
+      '@wry/caches': 1.0.1
+      '@wry/equality': 0.5.7
+      '@wry/trie': 0.5.0
+      graphql: 16.11.0
+      graphql-tag: 2.12.6(graphql@16.11.0)
+      hoist-non-react-statics: 3.3.2
+      optimism: 0.18.1
+      prop-types: 15.8.1
+      rehackt: 0.1.0(@types/react@19.1.8)(react@19.1.0)
+      symbol-observable: 4.0.0
+      ts-invariant: 0.10.3
+      tslib: 2.8.1
+      zen-observable-ts: 1.2.5
+    optionalDependencies:
+      react: 19.1.0
+      react-dom: 19.1.0(react@19.1.0)
+    transitivePeerDependencies:
+      - '@types/react'
+
   '@emnapi/core@1.4.4':
     dependencies:
       '@emnapi/wasi-threads': 1.0.3
@@ -1892,6 +2040,10 @@ snapshots:
       '@eslint/core': 0.15.1
       levn: 0.4.1
 
+  '@graphql-typed-document-node/core@3.2.0(graphql@16.11.0)':
+    dependencies:
+      graphql: 16.11.0
+
   '@humanfs/core@0.19.1': {}
 
   '@humanfs/node@0.16.6':
@@ -2316,6 +2468,22 @@ snapshots:
   '@unrs/resolver-binding-win32-x64-msvc@1.11.1':
     optional: true
 
+  '@wry/caches@1.0.1':
+    dependencies:
+      tslib: 2.8.1
+
+  '@wry/context@0.7.4':
+    dependencies:
+      tslib: 2.8.1
+
+  '@wry/equality@0.5.7':
+    dependencies:
+      tslib: 2.8.1
+
+  '@wry/trie@0.5.0':
+    dependencies:
+      tslib: 2.8.1
+
   acorn-jsx@5.3.2(acorn@8.15.0):
     dependencies:
       acorn: 8.15.0
@@ -2970,6 +3138,13 @@ snapshots:
 
   graphemer@1.4.0: {}
 
+  graphql-tag@2.12.6(graphql@16.11.0):
+    dependencies:
+      graphql: 16.11.0
+      tslib: 2.8.1
+
+  graphql@16.11.0: {}
+
   has-bigints@1.1.0: {}
 
   has-flag@4.0.0: {}
@@ -2992,6 +3167,10 @@ snapshots:
     dependencies:
       function-bind: 1.1.2
 
+  hoist-non-react-statics@3.3.2:
+    dependencies:
+      react-is: 16.13.1
+
   ignore@5.3.2: {}
 
   ignore@7.0.5: {}
@@ -3337,6 +3516,13 @@ snapshots:
       define-properties: 1.2.1
       es-object-atoms: 1.1.1
 
+  optimism@0.18.1:
+    dependencies:
+      '@wry/caches': 1.0.1
+      '@wry/context': 0.7.4
+      '@wry/trie': 0.5.0
+      tslib: 2.8.1
+
   optionator@0.9.4:
     dependencies:
       deep-is: 0.1.4
@@ -3433,6 +3619,11 @@ snapshots:
       gopd: 1.2.0
       set-function-name: 2.0.2
 
+  rehackt@0.1.0(@types/react@19.1.8)(react@19.1.0):
+    optionalDependencies:
+      '@types/react': 19.1.8
+      react: 19.1.0
+
   resolve-from@4.0.0: {}
 
   resolve-pkg-maps@1.0.0: {}
@@ -3647,6 +3838,8 @@ snapshots:
 
   supports-preserve-symlinks-flag@1.0.0: {}
 
+  symbol-observable@4.0.0: {}
+
   tailwindcss@4.1.11: {}
 
   tapable@2.2.2: {}
@@ -3673,6 +3866,10 @@ snapshots:
     dependencies:
       typescript: 5.8.3
 
+  ts-invariant@0.10.3:
+    dependencies:
+      tslib: 2.8.1
+
   tsconfig-paths@3.15.0:
     dependencies:
       '@types/json5': 0.0.29
@@ -3682,6 +3879,33 @@ snapshots:
 
   tslib@2.8.1: {}
 
+  turbo-darwin-64@2.5.4:
+    optional: true
+
+  turbo-darwin-arm64@2.5.4:
+    optional: true
+
+  turbo-linux-64@2.5.4:
+    optional: true
+
+  turbo-linux-arm64@2.5.4:
+    optional: true
+
+  turbo-windows-64@2.5.4:
+    optional: true
+
+  turbo-windows-arm64@2.5.4:
+    optional: true
+
+  turbo@2.5.4:
+    optionalDependencies:
+      turbo-darwin-64: 2.5.4
+      turbo-darwin-arm64: 2.5.4
+      turbo-linux-64: 2.5.4
+      turbo-linux-arm64: 2.5.4
+      turbo-windows-64: 2.5.4
+      turbo-windows-arm64: 2.5.4
+
   type-check@0.4.0:
     dependencies:
       prelude-ls: 1.2.1
@@ -3808,3 +4032,9 @@ snapshots:
   yallist@5.0.0: {}
 
   yocto-queue@0.1.0: {}
+
+  zen-observable-ts@1.2.5:
+    dependencies:
+      zen-observable: 0.8.15
+
+  zen-observable@0.8.15: {}

pnpm-workspace.yaml

@@ -1,5 +1,6 @@
 packages:
   - apps/*
+  - services/*
   - packages/*
 
 onlyBuiltDependencies:

scripts/db/01-init.sql

@@ -0,0 +1,16 @@
+-- LightSaver Database Initialization Script
+-- This script runs automatically when the PostgreSQL container starts for the first time
+
+-- Create extensions if needed
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+
+-- Add your table definitions here
+-- Example:
+-- CREATE TABLE IF NOT EXISTS users (
+--   id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+--   email VARCHAR(255) UNIQUE NOT NULL,
+--   created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+--   updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+-- );
+
+-- Add initial seed data here if needed

scripts/db/README.md

@@ -0,0 +1,21 @@
+# Database Initialization Scripts
+
+SQL scripts in this directory are automatically executed when the PostgreSQL container is first initialized.
+
+## Usage
+
+- Scripts are executed in alphabetical order
+- Use numbered prefixes (01-, 02-, etc.) to control execution order
+- Place schema definitions in early scripts
+- Place seed data in later scripts
+
+## Example
+
+- `01-init.sql` - Create extensions and initial schema
+- `02-seed.sql` - Insert initial data
+- `03-indexes.sql` - Create indexes
+
+## Notes
+
+- These scripts only run on first container creation
+- To re-run, you must remove the postgres volume: `make clean` or `podman-compose down -v`

services/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "api",
+  "version": "1.0.0",
+  "description": "",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.13.1",
+  "dependencies": {
+    "apollo-server-express": "^3.13.0",
+    "express": "^5.1.0",
+    "graphql": "^16.11.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/node": "^20.19.7",
+    "nodemon": "^3.1.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}

services/src/auth/index.ts

@@ -0,0 +1 @@
+console.log("Hello World!");

turbo.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://turborepo.com/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": [".next/**", "!.next/cache/**"]
+    },
+    "check-types": {
+      "dependsOn": ["^check-types"]
+    },
+    "dev": {
+      "persistent": true,
+      "cache": false
+    }
+  }
+}