fusion.ssg

Minimal SSG Framework For Building Static Websites

README

Minimal SSG Framework For Building Static Websites


HTML, Markdown, Front Matter + Custom .tsx and .jsx Components.

Installation


Full installation instructions can be found at fusionssg.com.

The Name


_fusion_ plays on the idea of _fusing_ together various elements (HTML, Markdown, Components, JSON data, YAML front matter, etc.).

Features


- No initial project configuration is required.
- DOMless and serverless results in very quick build times.
- HTML documents from markdown, HTML, tokens, components, JSON data sources and meta data.
- Support for .tsx and .jsx components, including sand-boxed execution, and for .ts browser scripts.
- Portfolio generation via collections.
- package.json scripts provided for development and release builds.
- CLI for one-off development and one-off release builds.
- Base URL support for sites hosted in sub folders.
- Works in progress for HTML documents that need to be ignored during release builds.
- Blogging support, including multiple categories and tags.
- Beautified HTML documents.

Project Development


The project is written in TypeScript (no excuses, _it just works beautifully_) and runs on Node.

Project Scope

The project's scope is limited to generating robust and resilient HTML documents and websites and requires no knowledge of other front-end frameworks. This keeps the scope of the project focused and preventing feature creep.

Versioning



What Still Remains To Be Done


- Logo, we'd welcome your contributing one.

Long Term Goals


- Seek RFC.
- Accept pull requests when procedures and policies are in place to govern the process.

Community


For help, discussion about best practices, or any other conversation that would benefit from being searchable:


For casual conversation with others about using _fusion.ssg_:


And If You Wouldn't Mind


Please consider 👀watching and 🌟starring this repo as these will provide the motivation to keep moving forward.