Developers

Developer guides for the Refresh App Web platform.

Getting Started

• Getting Started Guide - Initial setup and environment configuration

• Local Development Guide - Running the app locally

Core Guides

• Code Standards - TypeScript, Svelte 5, naming conventions, and PR process

• Route Management - Centralized routes, navigation, breadcrumbs, and page titles

• Authentication Guide - Auth flows and session management

• Database Guide - Database access, queries, and migrations

• Testing Guide - Unit tests, integration tests, and E2E testing

• Storybook Guide - Component development and visual testing

Quick Reference

Navigation

import { Routes, buildRoute } from '$lib/routes';
import { goto } from '$app/navigation';

// Static route
goto(Routes.APP_SURVEYS);

// Dynamic route
goto(buildRoute(Routes.APP_SURVEYS, surveyId));

Svelte 5 Runes

let count = $state(0);
let doubled = $derived(count * 2);

$effect(() => {
	console.log('Count changed:', count);
});

Page Labels (Breadcrumbs)

import { useBreadcrumbs } from '$lib/stores/breadcrumb.svelte';

const { setPageLabel } = useBreadcrumbs();

$effect(() => {
	if (data.item) {
		setPageLabel(data.item.name);
	}
});

Related Documentation

• Architecture Overview

• SvelteKit Architecture

• API Routes Reference

---

Last updated: January 2026