zo.space Development Guide

Read this skill before creating or editing any zo.space route. For deeper reference on specific topics, read the files in references/.

Architecture Overview

zo.space is a per-user web presence at {handle}.zo.space. It runs:

• Runtime: Bun 1.2.x
• Server framework: Hono (all HTTP routing)
• Frontend: React 19 + Vite 7 (SPA with client-side routing via react-router-dom)
• Styling: Tailwind CSS 4 with @tailwindcss/vite plugin + tw-animate-css
• Icons: lucide-react and @tabler/icons-react are both available

Routes are NOT files in the user's workspace. They exist only in the space system at /__substrate/space/routes/. Manage them exclusively through the space tools.

Tools