Development Setup

Set up a local development environment for Pelagica.

Pelagica is a monorepo made up of a frontend (React + Vite), a backend (Go), and a desktop shell (Go, via Wails) for the native app. The project uses Task to orchestrate all three.

Prerequisites

Tool	Version
Go	1.25+
Node.js	24.16+
pnpm	latest
Task	latest

NOTE

Building the desktop app has a few extra platform-specific prerequisites. See Desktop App for those.

Running the dev environment

Clone the repository and start the dev environment:

git clone https://github.com/PelagicaApp/pelagica.git
cd pelagica

task dev

NOTE

Dependencies are installed automatically on first run, and again whenever package.json, pnpm-lock.yaml, go.mod, or go.sum change.

This starts both the frontend and backend in parallel:

Frontend (Vite dev server) — http://localhost:3000
Backend (Go)

You can also run them individually:

task frontend   # Vite dev server only
task backend    # Go backend only
task desktop    # Desktop app shell only

To see all available tasks:

task --list

Next steps

Once your environment is running, see Contributing for guidelines on submitting changes.