Curvea

Introduction

The Curvea Stack

Curvea is the brand and developer ecosystem. The developer tooling is released together as the Curvea Stack , which has three developer-facing layers: Curvea Engine, Curvea CLI, and CurveaScript.

The Stack uses one release version while these layers ship together. Curvea Stack v0.1.1 is the current release documented here. Curvea itself is the brand and is not versioned.

Curvea Engine

The Engine parses CurveaScript, resolves templates and data, processes assets, renders routes, and writes the final static website to dist/.

It is responsible for areas such as:

  • .csc parsing
  • page/layout/component resolution
  • JSON and Markdown content
  • routing and pagination
  • SEO and sitemap output
  • CSS/JavaScript asset processing
  • document rendering

Curvea CLI

Curvea CLI is the command-line interface for project creation, development, builds, previews, scaffolding, and optional feature setup.

The @curvea/cli npm package distributes the current Curvea Stack and exposes the curvea command.

Core commands are:

curvea new
curvea dev
curvea build
curvea serve
curvea make
curvea add

Generated projects keep @curvea/cli as a local dev dependency and expose dev and build through npm scripts.

CurveaScript

CurveaScript is the template language processed by Curvea Engine. CurveaScript source files use the .csc extension, short for CurveaScript Code .

Every .csc file declares one role with a file declaration:

@page
@layout Main(title)
@component Hero(title)
@document

CurveaScript stays close to HTML while adding build-time composition, data, conditions, loops, and small template expressions.