Coralite v0.15.0

Thomas David - 6 Sept 25

Coralite v0.15.0 introduces a suite of enhancements that strengthen project automation, improve developer workflow, and expand support for modern web tooling. This release centers on stabilizing the build pipeline, refining configuration, and delivering better tooling for content and asset management.

Key Improvements #

This release brings significant upgrades to tooling, configuration, and runtime behavior. The core focus is on making Coralite more predictable, maintainable, and easier to use across different project types.

New CLI and Automation #

A new coralite-release package adds a dedicated CLI for version management and Git tagging. It simplifies the release process with built-in commands for version bumping, changelog generation, and tagging commits.

• Introduces changelog command to generate release notes from commit history and pull request metadata.
• Uses simple-git for reliable Git operations, including status checks before actions.
• Replaces outdated coralite-run binary with coralite-scripts as the primary CLI entry point.

Enhanced Build and Asset Support #

Support for SASS and SCSS compilation is now integrated directly into the build system with watch mode and source maps.

• Adds SASS compilation with file watching and rebuild on change.
• Introduces SCSS build script with source map output for debugging.
• Updates output path to css/ directory and removes redundant checks.
• Fixes import syntax to align with current SASS standards and removes deprecation warnings.

Content and Collection Improvements #

Collection handling has been overhauled to support more flexible file paths and clearer loading behavior.

• Adds rootDir option to CoraliteCollection constructor with trailing slash normalization.
• Introduces _loadByPath method to load collection items by file path, improving dynamic content access.
• Supports string paths for collection item handling, making configuration more intuitive.
• Normalizes collection root directory paths to prevent inconsistencies.

Developer Experience and Tooling #

Improvements to configuration, logging, and documentation make Coralite more approachable and reliable.

• Adds defineConfig utility and full TypeScript type definitions for better IDE support.
• Introduces response time logging middleware to help identify performance bottlenecks.
• Enhances JSDoc comments with parameter descriptions and default values.
• Updates workflow to use build-html script instead of direct html invocation.
• Removes outdated Node.js version checks to reduce friction in diverse environments.

Notable Fixes #

Several critical issues were resolved to improve stability and correctness.

• Reverts version from 0.15.0 to 0.14.2 due to unintended release tagging issues.
• Fixes static asset serving and HTML rendering logic to ensure correct output.
• Moves coralite from devDependencies to dependencies to ensure proper runtime availability.
• Renames binary from coralite-run to coralite-scripts for consistency and clarity.

Documentation and Community #

Documentation has been expanded to support new features and improve onboarding.

• Added detailed README for coralite-scripts.
• Improved JSDoc with full parameter and default value descriptions.
• Added inline comments to clarify internal logic and usage patterns.

How to Upgrade #

To upgrade to the stable version of Coralite v0.15.0, run:

npm install coralite@0.18.1

Ensure your project’s package.json includes coralite-scripts as the entry point, and update any scripts referencing coralite-run to use coralite-scripts instead.

For full details, view the full changelog.