managarten/docs/URL_SCHEMA.md

URL Schema - mana.how

This document defines the URL schema for all mana.how subdomains.

Naming Convention

• Landing Pages: Plural form (e.g., calendars.mana.how)
• Web Apps: Singular form (e.g., calendar.mana.how)
• APIs: Singular + -api suffix (e.g., calendar-api.mana.how)
• Short URLs: Redirect to Web Apps for convenience

---

Complete URL Mapping

Core Apps (Production)

App	Web App	API	Status
Calendar	calendar.mana.how	api.mana.how/calendar	Active
Clock	clock.mana.how	api.mana.how/clock	Active
Todo	todo.mana.how	api.mana.how/todo	Active
Contacts	contacts.mana.how	api.mana.how/contacts	Active
Chat	chat.mana.how	api.mana.how/chat	Active
Storage	storage.mana.how	api.mana.how/storage	Active
Zitare	zitare.mana.how	api.mana.how/zitare	Active
NutriPhi	nutriphi.mana.how	api.mana.how/nutriphi	Active
Presi	presi.mana.how	api.mana.how/presi	Active
SkillTree	skilltree.mana.how	api.mana.how/skilltree	Active
Photos	photos.mana.how	api.mana.how/photos	Active

Platform Services

Service	URL	Description
Main Dashboard	mana.how	Main landing/dashboard
Auth Service	auth.mana.how	Central authentication (mana-core-auth)
API Gateway	api.mana.how	Unified API gateway
Media Service	media.mana.how	Image/video processing
LLM Service	llm.mana.how	LLM abstraction layer
LLM Playground	playground.mana.how	LLM testing interface
Link Shortener	link.mana.how	URL shortener (uload)
File Storage	files.mana.how	MinIO/S3 file access

Matrix/Communication

Service	URL	Description
Matrix Server	matrix.mana.how	Synapse homeserver
Element Web	element.mana.how	Matrix web client
N8N	n.mana.how	Workflow automation

Monitoring & Admin

Service	URL	Description
Grafana	grafana.mana.how	Metrics dashboards
Umami	(internal :8010)	Web analytics

Umami Tracking (Analytics)

For web analytics, the following apps are tracked in Umami:

Umami Website ID	Display Name	Domain
manacore-webapp	Dashboard	mana.how
chat-webapp	Chat	chat.mana.how
todo-webapp	Todo	todo.mana.how
calendar-webapp	Calendar	calendar.mana.how
clock-webapp	Clock	clock.mana.how
contacts-webapp	Contacts	contacts.mana.how
storage-webapp	Storage	storage.mana.how
zitare-webapp	Zitare	zitare.mana.how
nutriphi-webapp	NutriPhi	nutriphi.mana.how
presi-webapp	Presi	presi.mana.how
skilltree-webapp	SkillTree	skilltree.mana.how
photos-webapp	Photos	photos.mana.how

---

Short URL Redirects

Convenience redirects for quick access to Web Apps:

Short URL	Redirects To
cal.mana.how	calendar.mana.how
clok.mana.how	clock.mana.how
con.mana.how	contact.mana.how
pic.mana.how	picture.mana.how
zit.mana.how	zitare.mana.how

---

Hosting

Landing Pages (Astro Static Sites)

Platform: Cloudflare Pages

Landing pages are deployed via Cloudflare Pages using Wrangler CLI:

# Deploy individual landing page
pnpm deploy:landing:calendar
pnpm deploy:landing:clock
pnpm deploy:landing:todo
pnpm deploy:landing:contacts
pnpm deploy:landing:chat
pnpm deploy:landing:picture
pnpm deploy:landing:zitare

# Deploy all landing pages
pnpm deploy:landing:all

Cloudflare Project Names:

App	Cloudflare Project	Custom Domain
Calendar	calendars-landing	calendars.mana.how
Clock	clocks-landing	clocks.mana.how
Todo	todos-landing	todos.mana.how
Contacts	contacts-landing	contacts.mana.how
Chat	chats-landing	chats.mana.how
Picture	pictures-landing	pictures.mana.how
Zitare	zitares-landing	zitares.mana.how

Web Apps & APIs

Platform: Mac Mini (self-hosted) via Docker + Cloudflare Tunnel

---

DNS Configuration

Web apps and APIs are routed via Cloudflare Tunnel to the Mac Mini. Landing pages use Cloudflare Pages.

Cloudflare Tunnel (Web Apps & APIs)

All *.mana.how subdomains are routed via Cloudflare Tunnel to the Mac Mini Docker containers. No A records needed — Cloudflare manages the DNS.

CNAME Records (Cloudflare - Landing Pages)

calendars.mana.how   CNAME  calendars-landing.pages.dev
clocks.mana.how      CNAME  clocks-landing.pages.dev
todos.mana.how       CNAME  todos-landing.pages.dev
contacts.mana.how    CNAME  contacts-landing.pages.dev
chats.mana.how       CNAME  chats-landing.pages.dev
pictures.mana.how    CNAME  pictures-landing.pages.dev
zitares.mana.how     CNAME  zitares-landing.pages.dev

Short URL Redirects (Cloudflare Redirect Rules or CNAME)

cal.mana.how   → 301 redirect to calendar.mana.how
clok.mana.how  → 301 redirect to clock.mana.how
con.mana.how   → 301 redirect to contact.mana.how
pic.mana.how   → 301 redirect to picture.mana.how
zit.mana.how   → 301 redirect to zitare.mana.how

---

Adding a New App

1. Create landing page in apps/{app}/apps/landing/
2. Add wrangler.toml with project name {apps}-landing
3. Add deploy script to root package.json
4. Create Cloudflare Pages project: npx wrangler pages project create {apps}-landing
5. Add custom domain in Cloudflare dashboard
6. Update this documentation