Skip to content
SoulTales Docs

Frontend overview

Public Astro site architecture and stack.

The public site lives in frontend/ and is deployed to Cloudflare Workers (soultales-www).

Stack

Section titled “Stack”
  • Astro 7 with Vue 3 islands
  • Tailwind CSS 4
  • Directus SDK for content
  • Better Auth with Drizzle adapter and Turso
  • Pagefind for search
  • i18n: en, nl, de, fr, es, it

Key paths

Section titled “Key paths”
  • src/util/directus.ts: Directus client and queries
  • src/content.config.ts: content collections
  • src/db/schema.ts: Drizzle schema (users, sessions, favorites)
  • src/auth.ts: OAuth and email providers

Build

Section titled “Build”
Terminal window
pnpm dev:frontend
pnpm --filter soultales-frontend build

Deploy and secrets: see frontend/DEPLOY.md in the monorepo.

soultales.com Partner portal Partner docs

Overview

Introduction Architecture Environments Platform stack Services & vendors

Frontend

Overview Auth & users Directus integration

Dashboard

Overview Partner flows Billing

Backend

Directus Extensions Deploy on Fly

Operations

Deploy runbooks Secrets Helpdesk

Contributing

Local development Monorepo commands