Synkronus Portal Development

Complete guide for developing the Synkronus Portal web interface.

Prerequisites

• Node.js 20+ and npm
• Go 1.22+ (for backend)
• PostgreSQL 17+ (for backend)

Local Development Setup

Dockerless Development

Step 1: Set Up Backend

See Synkronus Development for backend setup.

Step 2: Set Up Frontend

cd synkronus-portal
npm install

Step 3: Start Development Server

npm run dev

Portal available at http://localhost:5174

Docker Development

Start Backend Services

docker compose up -d postgres synkronus

Start Frontend

cd synkronus-portal
npm install
npm run dev

Portal available at http://localhost:5174

Development Features

• Hot Module Replacement: Instant code updates
• Fast Refresh: React components update without losing state
• Source Maps: Debug in browser DevTools
• Error Overlay: Errors shown in browser

Building for Production

Build

npm run build

Output in dist/ directory.

Docker Production Build

docker compose up -d --build

Project Structure

• src/: React source code
• src/components/: Reusable components
• src/pages/: Page components
• src/services/: API service
• src/contexts/: React contexts

Adding Features

See Synkronus Portal Reference for detailed patterns.

Related Documentation

• Synkronus Portal Reference - Component reference
• Deployment Guide - Production deployment