Docs
chromia.com

What’s new

On this page

Releases of the Chromia toolchain and changes to these docs, newest first. Versions are read from the public repositories on gitlab.com/chromaway and from npm.

Latest versions

As of 3 November 2026 (re-checked against npm and GitLab for r30).

ComponentLatestReleasedNotes
Chromia CLI (chr)0.34.313 Oct 2026Release notes
Rell0.16.714 Aug 2026Rell releases
Postchain3.49.2323 Oct 2026GitLab ↗
Directory chain1.110.112 Sep 2026GitLab ↗
postchain-client (JavaScript)2.1.515 Apr 2026npm ↗
postchain-client (Kotlin)3.39.724 Sep 2026GitLab ↗
FT4 TypeScript client (@chromia/ft4)2.1.015 Dec 2025npm ↗
Chromia MCP server0.3.228 Oct 2026Docs
Rell LSP MCP server0.1.114 Aug 2026GitLab ↗

An FT4 client beta, 2.1.2-beta.0, was published on 15 Apr 2026.

2026 releases

November 2026

  • Docs r30 (3 Nov). The docs now share chromia.com’s design: its typefaces, palette, logo, buttons and cards, in light and dark. Getting started is one path: install and run a first dapp, then deploy to Testnet (rewritten, every command checked against chr 0.34.3). The local tutorial was re-run with chr 0.34.3 and every output still matches. “dapp” is now spelled one way across the docs, 317 pages no longer skip heading levels, and the Testnet Vault link was fixed.

October 2026

  • Chromia CLI 0.34.0 – 0.34.3. Rell 0.16.6, then 0.16.7, and postchain-chromia 3.40.0 (the node package bundled with the CLI, versioned separately from the Postchain node below; chr --version prints the Postchain core it runs, 3.49.21 in 0.34.3). The chr Docker image now carries OCI provenance labels. Notes
  • Postchain 3.49.22 and 3.49.23. Node releases on 13 and 23 Oct. GitLab releases
  • Chromia MCP server 0.3. Versions 0.3.0 – 0.3.2 were tagged on 28 Oct. The server lets AI assistants query network data and search the Chromia docs. MCP server docs

August 2026

  • Rell 0.16.5 – 0.16.7.
    • Linter fixes no longer corrupt re-indented lines.
    • New refactorings convert a function body between block and expression form.
    • Run-time failures no longer print a Java stack trace.
    • Rell has a smaller dependency footprint, which makes it easier to embed in GraalVM native images.
    Rell releases
  • Rell LSP MCP server 0.1. Gives AI coding agents such as Claude Code and Cursor the Rell language server: types, completions, diagnostics, navigation and refactorings. It ships as a container image. GitLab

Earlier in 2026

  • Chromia CLI 0.33.0 (30 May) moves to Rell 0.16.0. 0.33.1 (25 Jun) updates Postchain to 3.49.16.
  • Chromia CLI 0.32 (19 Apr – 6 May) reads network targets from the ChromiaPredefinedNetworks API. chr install skips the library chain when there is nothing to install.
  • Chromia CLI 0.31 (4 – 12 Mar) adds retracting a governance vote. chr test now writes the SQL log as an HTML report, which replaces --sql-log.
  • Chromia CLI 0.30.0 (27 Feb) writes deployment results back to chromia.yml, and chr deployment update now detects enum changes.

Docs updates

November 2026

  • FT4 guides open with an “At a glance” box: when to use the feature, what to watch out for, and links to its API reference. New diagrams show account registration, authentication, login and transfers.
  • Troubleshooting & FAQ. The nine errors newcomers hit most, each with the cause and the fix.
  • Code blocks tell commands from output, colour every language in light and dark, and copy commands without the $ prompt.
  • New home page. One path in: run Rell in the browser, then zero to a running dapp in 10 minutes, then deploy.
  • Playground. Edit and run Rell examples without installing anything.
  • Search across every page, including the API references.
  • Release notes are current again: CLI to 0.34.3 and Rell to 0.16.7.
  • Postchain REST API links now open the right endpoint.
  • Courses now live at chromia.com/learn.
2025 docs updates

User Interface & Navigation Improvements

Optimized Sidebar and Navigation Font Sizes

  • Reduced base font size from 16px to 14px for sidebar menu items and top navigation
  • Improved information density and visual scanning speed
  • Enhanced readability with optimized line-height ratios
  • Better responsiveness across different screen sizes and viewports

Content Layout Optimization

  • Added max-width constraints to documentation content (80% on larger screens) for optimal line length
  • Centered breadcrumb navigation for better visual hierarchy
  • Improved tab responsiveness on tablet viewports

Deployment Section Restructuring

Mainnet Deployment Focus

  • Renamed "Deploy your dapp" section to "Deployment" with clearer mainnet-focused messaging
  • Removed redundant testnet deployment section from main deployment area
  • Centralized testnet tokens information as a dedicated section within Deployment
  • Streamlined deployment flow by making mainnet deployment the primary path
  • Preserved simplified testnet deployment in Getting Started for quick testing workflows

Container Setup Improvements

  • Consolidated key pair generation into prerequisites with links to centralized key management documentation
  • Reorganized container leasing steps for clearer workflow
  • Improved cross-references between deployment documentation sections

Getting Started Section Improvements

Content Organization

  • Moved installation documentation out of Getting Started into a dedicated Installation section
  • Removed duplicate Quick Start section that appeared twice
  • Simplified Hello World flow by removing "Interact with your dapp" step from the initial tutorial
  • Enhanced testnet deployment guide with clearer step-by-step instructions and better integration with Getting Started flow

Testnet Quick Path

  • Improved testnet getting-started page with clearer step-by-step progression
  • Merged testnet deployment workflows for better user experience
  • Enhanced click-through navigation while maintaining step-by-step guidance clarity

Key Management Centralization

Unified Key Documentation

  • Centralized key pair generation documentation in CLI command reference
  • Created comprehensive Key Pair Management guide covering all key operations
  • Improved workflow by linking key generation before management documentation
  • Enhanced keygen command documentation with practical examples and use cases
  • Added prerequisites section in Key Pair Management linking to generation documentation

Token Chain Documentation

Fees and Integration Guide

  • Added detailed explanation of Token chain fees and pricing
  • Created step-by-step guide for setting up tokens and bridges on Token chain
  • Enhanced Cookbook section with practical token chain integration examples

Installation Documentation

PostgreSQL Setup Improvements

  • Added locale error troubleshooting for macOS, Linux, and Windows
  • Created expandable troubleshooting sections for common PostgreSQL installation issues
  • Improved cross-platform guidance with platform-specific locale examples
  • Enhanced peer authentication troubleshooting with clear fix instructions