Cav

A collection of primitives for building full-stack web apps with Deno.

Status: Ready to play with, but not ready for production.

Index

• Guiding principles
• Goals
• Inspirations
• Examples
• Setup
• Getting started
• Conventions
• API

Guiding principles

• Least Astonishment
• Modular, schema-like server definitions
• No-fuss data serialization
• End-to-end typesafety
• Developer independence
• Use the platform
• Have fun 🌈

Goals

• It should do the basics
  • Routing
  • Static asset serving
  • Signed cookies
  • Web sockets
  • Form and JSON parsing
  • De/serialization of most JS data types, including Dates, Maps, Files…
  • Runtime bundling for browser-side TypeScript
  • Works with frontend frameworks like Preact
• It shouldn’t require special configs, setups, or tooling
  • No config files
  • No CLI
  • No dictated project structures
• The client function should use types imported from the server to fully type requests and responses
  • End-to-end typesafety
  • Compatible with Zod
• Its syntax should be functional and declarative
  • Immutable, schema-like Router and Endpoint definitions
  • No middleware patterns
  • Functions all the way down
• It should be as independent as possible
  • Zero third-party dependencies (just Deno)
• Production deployments should be a simple git-commit-push
  • Deno Deploy without a build step

Inspirations

• Express / Koa / Oak
• Zod / tRPC
• superjson / devalue / json-dry

Cav’s description on GitHub is inspired by the Weird Wide Webring 🤙

Examples

TODO

Setup

TODO

Getting started

TODO

Conventions

TODO

API