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
mainbranch)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.