Files

Thomas Hallock bda5bc6c0e fix: prevent database imports from being bundled into client code

**Problem:**
- player-ownership.ts imported drizzle-orm and @/db at top level
- When RoomMemoryPairsProvider imported client-safe utilities, Webpack bundled ALL imports including database code
- This caused hydration error: "The 'original' argument must be of type Function"
- Node.js util.promisify was being called in browser context

**Solution:**
1. Created player-ownership.client.ts with ONLY client-safe utilities
   - No database imports
   - Safe to import from 'use client' components
   - Contains: buildPlayerOwnershipFromRoomData(), buildPlayerMetadata(), helper functions

2. Updated player-ownership.ts to re-export client utilities and add server-only functions
   - Re-exports everything from .client.ts
   - Adds buildPlayerOwnershipMap() (async, database-backed)
   - Safe to import from server components/API routes

3. Updated RoomMemoryPairsProvider to import from .client.ts

**Result:**
- No more hydration errors on /arcade/room
- Client bundle doesn't include database code
- Server code can still use both client and server utilities

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-10 11:40:46 -05:00

2.1 KiB

Raw Blame History

NAS Deployment for Soroban Abacus Flashcards

This directory contains the deployment configuration for running the Soroban Abacus Flashcards (apps/web) on your NAS at abaci.one.

Quick Deployment

After pushing code changes to trigger the GitHub Actions build:

# From the project root
./nas-deployment/deploy.sh

Manual Deployment

Copy files to NAS:

scp nas-deployment/docker-compose.yaml nas.home.network:/volume1/homes/antialias/projects/abaci.one/
scp nas-deployment/.env nas.home.network:/volume1/homes/antialias/projects/abaci.one/

Deploy:

ssh nas.home.network "cd /volume1/homes/antialias/projects/abaci.one && docker-compose up -d"

Services

Soroban Flashcards: Main Next.js app at https://abaci.one
DDNS Updater: Keeps Porkbun DNS updated with current WAN IP
Watchtower: Auto-updates containers every 5 minutes when new images are pushed

Configuration

Environment Variables

Copy .env.example to .env and customize as needed.

DDNS Configuration

The Porkbun DDNS configuration is in ddns-data/ddns-config.json and handles:

Domain: abaci.one
Provider: Porkbun
Auto IP detection via ipinfo.io
TTL: 300 seconds

Traefik Integration

Automatic HTTPS via Let's Encrypt
HTTP → HTTPS redirect
HSTS headers for security

Monitoring

Container status: ssh nas.home.network 'cd /volume1/homes/antialias/projects/abaci.one && docker-compose ps'
Application logs: ssh nas.home.network 'cd /volume1/homes/antialias/projects/abaci.one && docker-compose logs -f soroban-abacus-flashcards'
DDNS web UI: http://[NAS-IP]:8000

Architecture

GitHub Actions → ghcr.io/antialias/soroban-abacus-flashcards:latest
                 ↓
NAS → docker-compose → Traefik → abaci.one
      ↓
      Watchtower (auto-update every 5min)
      DDNS (Porkbun IP sync)

Files

docker-compose.yaml: Main deployment configuration
deploy.sh: Automated deployment script
.env.example: Environment variables template
ddns-data/ddns-config.json: Porkbun DDNS configuration
README.md: This file

2.1 KiB Raw Blame History