Engineering

Tech Stack

Ferndesk runs on a modern JavaScript stack optimized for speed and DX. This guide outlines core technologies and infrastructure.

Frontend & Framework

  • SvelteKit – Full-stack framework for routing, SSR, and API endpoints

  • Svelte – Component framework with compile-time reactivity

  • TypeScript – Type-safe JavaScript across the codebase

Backend & Runtime

  • Node.js – Server runtime for SvelteKit and API routes

Jobs

  • BullMQ - Queues (currently looking to replace with Restate)

Database

  • Postgres – Primary relational database

  • Redis - For KV storage and job queues with BullMQ

  • Planetscale – Managed Postgres hosting with branching and migration tools

Infrastructure & Hosting

  • Railway – Application hosting and deployment (auto-deploys from main branch)

  • Cloudflare – CDN, DNS, and edge caching for performance

Package Management

  • pnpm – Fast, disk-efficient package manager (required for local dev)

# Install dependencies
pnpm install

# Run dev server
pnpm dev

# Build for production
pnpm build

Always use pnpm – npm/yarn/bun may cause lockfile conflicts.

Third-Party Services

Beyond core infrastructure, Ferndesk integrates with external APIs for AI, support tools, and analytics. Details vary by feature – consult Wilson for service-specific configs and credentials.

Questions about architecture, migrations, or tooling? Wilson is the primary resource for stack decisions.

Was this helpful?