PLIEGORS / DOCUMENTATION

Build the whole document in Rust.

Start with useful HTML, add state that can explain itself, and admit browser libraries only through explicit lifecycle boundaries.

PLIEGORS / 0.4.0-BETA.1 / 21 CRATES

One coordinated public beta.

The CLI and all twenty library crates are published on crates.io at the exact 0.4.0-beta.1 version, including pliego-router, pliego-runtime, pliego-data, pliego-pboc, pliego-cloudflare, and pliego-sdk. G1, G2, G3, and OpenSDK move as one graph; PBOC v1alpha1 remains a preview contract.

Inspect current capabilities Evaluate the native runtime Use the G2 beta Deploy one sealed PBOC Evaluate OpenSDK Open the coordinated beta Read the release boundary

START / 04 COMMANDS

From zero to a running project.

The default starter is intentionally small, but it is not blank: it teaches the route graph, authored errors, metadata, assets, and the build ledger.

shell

pliego new my-app
cd my-app
pliego check
pliego dev

Search documentation

Start

Getting started

Install the CLI, create a project, start the development server, and produce the first verified build.

Start

Project structure

Understand pliego.toml, the site package, the optional WASM client, public assets, and output ownership.

Start

CLI reference

Use the project, diagnostics, upgrade, release-inspection, and voluntary telemetry command surfaces.

Start

Developer loop

Follow native file events through typed HMR, causal build graphs, artifact explanations, and recovery without losing the last valid output.

Start

Incremental builds

Use verified no-ops, explicit lazy-route dependencies, observable reuse, and private cache controls without weakening atomic publication.

Author

Routing and pages

Create complete HTML documents, canonical metadata, clean routes, redirects, and authored error pages.

Author

Rust views

Compose semantic views with escaped text, typed macros, stable attributes, and useful HTML first.

State

Events and folds

Model durable facts, deterministic projections, replay parity, snapshots, and explicit effects.

State

Schemas and snapshots

Version events, seal adjacent upcasters, bind projection identity, and restore snapshots only against an exact compatible contract.

State

Hyphae verified sync

Append and replay durable history through signed attestations, fixed snapshots, authority policy, and consuming verification types.

Author

Typed content

Load bounded Markdown, JSON, and TOML collections with stable identities and actionable errors.

Runtime

Browser runtime

Resume Rust/WASM behavior and admit GSAP, Lenis, Three.js, or WebGL through lifecycle adapters.

Runtime

DOM ownership

Own mounted ranges, reconcile keyed children, adopt exact SSR output, and dispose listeners, effects, adapters, and nodes deterministically.

Runtime

Native runtime preview

Install the public G1 router and runtime preview, then evaluate HTTP/2, route-owned layouts, bounded lifecycle, and three SSR modes.

Delivery

Portable deployment

Validate one sealed PBOC, admit native or Cloudflare hosts, and prove rolling and rollback compatibility before upload.

Runtime

Full-stack beta

Use the published G2 loaders, progressive actions, sessions, cache isolation, invalidation, and receipt-driven diagnostics.

OpenSDK

OpenSDK preview

Install the public OpenSDK preview and understand admission, capabilities, effects, conformance, and its pending governance.

OpenSDK

Components and languages

Run the typed Wasm Component host and compare the bounded Rust, TypeScript, and Python conformance implementations.

OpenSDK

Browser framework conformance

Integrate React, Svelte, and Lit through explicit Custom Element and adapter lifecycles with measurable cleanup.

OpenSDK

Tooling protocol

Negotiate editor and MCP clients over bounded JSON-RPC without granting ambient project or network authority.

OpenSDK

Compatibility and deprecation

Read the machine-verifiable support matrix, stability tiers, migration requirements, and provider-neutral source boundary.

Delivery

Adaptive assets

Plan reproducible images, video, fonts, and 3D variants under explicit device budgets.

Delivery

Artifact trust

Understand portable namespaces, exact source capture, staged publication, build receipts, causal graphs, and fail-closed verification.

Delivery

Release trust

Verify deterministic archives, signatures, attestations, provenance, and release-only promotion evidence.

Operate

Performance evidence

Reproduce benchmark observations, read their hardware context, and keep measurements separate from claims.

Operate

Errors and diagnostics

Read stable PLG codes, browser build failures, JSON diagnostics, exit codes, and recovery actions.

Operate

Voluntary telemetry

Control a disabled-by-default, local-only usage journal with an exact field allowlist and user-owned deletion.

Delivery

Build and deploy

Verify the output ledger, preview production bytes, select release artifacts, and deploy static output.

Reference

Crates and API

Choose the public crate that owns each contract, generate exact-version Rustdoc, and avoid depending on implementation-only internals.

Project

Licensing and policy

Understand Apache-2.0, third-party notices, trademarks, security reports, support, and contributions.