AstralBeam

A Vite+ monorepo with a TanStack Start application and shared shadcn/ui components.

apps/
  webapp/       @astralbeam/webapp  # TanStack Start application
  www/          @astralbeam/www     # Public website
packages/
  brand/        @astralbeam/brand   # Shared palette and approved light/dark logo assets
  db/           @astralbeam/db      # Server-only Drizzle client and schemas
  ui/           @astralbeam/ui      # Shared styles, components, and utilities

Local development

Choose either the included devcontainer or the direct macOS workflow. Follow SETUP.md for prerequisites and the PostgreSQL and Valkey service lifecycle.

vp install
vp run webapp # Starts app on http://localhost:3000
vp run www # Starts website on http://localhost:3001

Add shadcn components to the shared UI package:

vp run ui add button

Validate and build

Use vp run -r <script> for tasks that must run in every workspace package. Before running vp run knip:fix, commit or back up untracked work because it can delete unused files that Git cannot restore; then review the resulting diff before running recursive Vite+ checks and fixes with vp run -r check:fix.

• Run formatting, linting, TypeScript, and unused-code checks:

  vp run check

• Run tests:

  vp run test

• Build the product application:

  vp run @astralbeam/webapp#build

Licensing

Portions of this repository are licensed as follows:

• Files under apps/www are licensed under the MIT License, except for third-party material governed by its applicable license.
• All other files in this repository are licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only), except where an adjacent license or notice states otherwise.
• Third-party components and materials are licensed under the applicable licenses provided by their respective owners. See third-party notices.

Copyright © 2026 AstralBeam Inc. for AstralBeam-controlled material. Third-party material remains subject to its respective copyright and license terms.

Tasks

• How to Create Server Routes
• Add Better Auth
• Add react-email
• Update to Latest TanStack Start API (if needed)
• Set up CLAUDE.md properly
• Claude Worktree Workflow (3 agents together)
• Explain recommended folder structure
• Example of how to use effect-ts
• Deployment on Cloud VM (Hetzner/AWS)
• how to set up middleware