Coralite

coralite is a static site generator library built around the emerging HTML modules proposal.

• Getting started
  • Installation
  • Basic templating
• Reference
  • Coralite CLI
  • Coralite
  • Plugin system
    • Create plugin
      • The definePlugin function is the entry point for extending Coralite's functionality.
    • Define component
      • The defineComponent plugin is Coralite's core built-in plugin that enables dynamic template functionality.
    • Ref
      • The refs plugin is a built-in Coralite helper that provides runtime DOM element access.
    • Metadata
      • The metadata plugin is a built-in Coralite tool that extracts metadata from tags in your page's and makes them available as template variables.
  • Types

Installation

Before using the Coralite CLI, ensure that it's installed on your system. You can install it globally using npm:

npm install -g coralite

You can also install coralite as a development dependency:

npm install --save-dev coralite

Basic Syntax

Coralite is executed using the following command:

coralite [options]

For more information about the

Replace [options] with the desired flags and arguments.

Required Options

To generate a website using Coralite, you must provide three essential options:

• -t or --components: The path to your components directory containing reusable UI elements (e.g., -t src/components).
• -p or --pages: The path to your pages directory where static HTML files reside (e.g., -p src/pages).
• --output or -o: The output directory for the generated site (e.g., --output dist).

Here's an example of how these options might look:

coralite --components path/to/components --pages path/to/pages --output dist

Optional Options

-d or --dry-run

Run the CLI in dry-run mode to preview the actions that would be performed without actually generating the website. This is useful for debugging or when you want to check potential issues before committing changes:

coralite --components path/to/components --pages path/to/pages --output dist --dry-run