Minimal 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 document composition from markdown, HTML, tokens, .jsx and .tsx components, JSON data sources and meta data.
- .tsx and .jsx sand-boxed exaction.
- .ts browser scripts.
- Portfolio (multiple pages) generation via collections.
- Generated projects provide package.json scripts 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 should be ignored during release builds.
- Blogging support, including multiple categories and tags.
- Optional cache busting during release builds for your project's assets (v1.2.0).
- Conditional composition of includes based on build strategy (v1.2.0).
- The reporting of works in progress during release builds (v1.2.0).
- Additional post metadata exposed as simple tokens (v1.2.0).
- 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
Current version: v1.2.0. We use Semantic Versioning.
What Still Remains To Be Done
- fusion.ssg deserves an awesome logo. If you are a graphic artist 🎨, we would love ❤️ your contribution to this project and we we'd be thrilled to give you well-deserved, prominent attribution! Please reply via issues.
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:
Discuss _fusion.ssg _on Github
For casual conversation with others about using fusion.ssg:
Discuss _fusion.ssg on Twitter and other social media..
And If You Wouldn't Mind
Please consider 👀watching and 🌟starring this repo as these will provide the motivation to keep moving forward.