butcss

CSS but as server

/_next/static/media/ray-so-export.47759fb9.png

A PostCSS-based backend framework that lets you write server logic in CSS syntax. Compiles CSS files with custom syntax into Express.js servers with HTTP routing and SQLite support.

butcss

A PostCSS-based backend framework that lets you write server logic in CSS syntax.

Overview

css-server parses CSS files with custom syntax and compiles them into an Express.js server. It supports:

HTTP routing via CSS selectors ([path="/users"]:GET)
SQLite database queries via sql() function
Request data extraction (params, query, body, headers)
Conditional logic via if() expressions
Dynamic status codes and responses

Installation

pnpm install
pnpm build

Quick Start

node dist/cli.js ./examples/crud.css

Examples live in ./examples/.

Example

@server {
  port: env(PORT, 3000);
  database: env(DATABASE, ./app.db);
}

@database {
  CREATE TABLE users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT,
    email TEXT
  );
}

[path="/users"]:GET {
  @return json(sql("SELECT * FROM users"));
}

[path="/users/:id"]:GET {
  --id: param(:id);
  --user: sql("SELECT * FROM users WHERE id = ?", var(--id));
  @return json(if(--user: var(--user); else: { "error": "Not found" }));
}

[path="/users"]:POST {
  --name: body(name);
  --email: body(email);
  @return json(sql("INSERT INTO users (name, email) VALUES (?, ?)", var(--name), var(--email)));
}

CLI

Usage: css-server <file>

Running Tests

pnpm test

License

MIT