CASTD Distribution

Distribution package for the CASTD stackless webserver.

About

CASTD is built by Vivian Voss as part of Min2Max, ultralight web tools inspired by the demoscene. Read technical articles about the architecture at vivianvoss.net/blog.

Quick Start

# Start the server with your bundle
./castd/castd.sh start --bundle my-project

# Or with custom port
./castd/castd.sh start --bundle my-project --port 3000

# Stop the server
./castd/castd.sh stop

Directory Structure

dist/
├── castd/           # Framework (DO NOT MODIFY)
│   ├── backend/
│   │   ├── bin/          # Server binary
│   │   └── extensions/   # Lua extensions (sample: currency_convert)
│   ├── frontend/
│   │   ├── assets/       # CSS, JS, images
│   │   └── presets/      # Components, extensions, themes
│   └── castd.sh     # Control script
├── workspace/            # Your bundles go here
│   └── my-project/       # Example bundle
│       ├── assets/
│       ├── presets/
│       └── templates/
└── manuals/              # Documentation

Creating a Bundle

1. Create a directory in workspace/:

   mkdir -p workspace/my-project/{assets,presets,templates}

2. Add your templates to workspace/my-project/templates/

3. Start the server:

   ./castd/castd.sh start --bundle my-project

Documentation

Full documentation will be available at castd.run — currently under construction, launching soon.

Source Code

The complete source code is included in castd/backend/src.tar.xz.

tar xf castd/backend/src.tar.xz
cargo build --release

Licence

Apache-2.0 — Copyright 2025 Vivian Voss. See LICENSE and NOTICE.