Development & Roadmap

Development

cd ~/atelier/_projects/personal/domus-digitalis

# Start services
docker compose up -d

# Backend (terminal 1)
cd apps/backend && npm run dev

# Frontend (terminal 2)
cd apps/frontend && npm run dev

# Seed projects
cd apps/backend && npm run db:seed

Goals

  • Project CRUD with document types

  • Visual Atelier workspace (4 editors)

  • AsciiDoc support

  • Seed script for projects

  • Book/chapter tracking

  • Multi-language support (7 languages)

  • Deploy to production

  • Authentication flow complete

Planned Refactor: Eliminate Railway

Consolidate Express backend into Next.js API routes to simplify architecture.

Current State

Component Platform

Next.js frontend

Vercel

Express backend

Railway

PostgreSQL

Railway

Redis

Railway

Target State

Component Platform

Next.js (frontend + API routes)

Vercel

PostgreSQL

Vercel Postgres or Railway (DB only)

Redis/KV

Vercel KV (if needed)

Migration Steps

  1. Move Prisma schema to apps/frontend/prisma/

  2. Convert Express routes to Next.js API routes (app/api/*/route.ts)

  3. Migrate PostgreSQL to Vercel Postgres (or keep Railway DB)

  4. Replace Redis with Vercel KV (or remove if just caching)

  5. Delete apps/backend/ directory

  6. Cancel Railway backend service

Benefits

  • Single deployment (Vercel only)

  • Lower cost (eliminate Railway compute tier)

  • Simpler architecture

  • One codebase to maintain