Home
Softono
cloesce

cloesce

Open source Apache-2.0 Rust
33
Stars
5
Forks
14
Issues
0
Watchers
1 week
Last Commit

About cloesce

The Schema Language for Cloudflare

Platforms

Web Self-hosted Cloud

Languages

Rust

cloesce (alpha, v0.4.0)

[!WARNING] Cloesce is under active development, expanding its feature set as it pushes toward full Cloudflare support across any language. The syntax and features described here are subject to change as the project evolves.

Cloesce is a schema language that describes a full stack application built on Cloudflare's edge ecosystem. From one language, generate an entire application with support for:

Feature Support
ORM
RPC stubs
Infrastructure as Code
SQL Migrations
Middleware
Runtime Type Validation

How Easy can Full Stack Development Be?

env {
    d1 { db }
    kv { namespace }
    r2 { bucket }
}

[use db]
[crud get, save, list]
model User {
    primary {
        id: int
    }

    column {
        name: string
    }

    nav(Posts::id) {
        posts
    }

    kv(namespace, "user/settings/{id}") {
        settings: json
    }

    r2(bucket, "user/avatars/{id}.png") {
        avatar
    }
}

api User {
    get helloWorld(self) -> User
}

Documentation

See the Cloesce Docs for more information on getting started, language features, architecture, and roadmap.

Utilize an LLM to interact with the docs in a conversational way:

curl https://cloesce.pages.dev/llms-full.txt -o llms-full.txt

VS Code Extension

A basic language highlighting extension for Cloesce is available in the VS Code marketplace. In the future, this extension will also include a full LSP server.

More editor integrations are planned for the future (and you can always contribute your own!). If you're interested in contributing an editor extension, reach out in the Discord server.

Contributing

Contributions are welcome at all levels. Join our Discord to discuss ideas, report issues, or get help getting started. Create an issue on GitHub if you find a bug or have a feature request.

Coalesce

Check out Coalesce, an accelerated web app framework for Vue.js and Entity Framework by IntelliTect. Cloesce takes much of its inspiration from Coalesce (Cloesce = Cloudflare + Coalesce).

Building, Formatting, Testing

Prerequisites

Before building, ensure you have the required dependencies installed:

Required:

Optional:

  • pandoc (for documentation) - brew install pandoc
  • mdbook (for documentation) - cargo install mdbook

Run make check-deps to verify your setup.

Build Commands

All relevant commands can be found in the Makefile in the project root. Run make all to build, format and test all packages.