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.
- Effortless project creation using fusion.ssg's project generator.
- DOMless and serverless execution produces very quick build times.
- HTML document composition from markdown, HTML, tokens, .jsx and .tsx components, JSON data sources and meta data.
- .tsx and .jsx compilation and sand-boxed execution.
- .ts browser script compilations.
- 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.
- HTML documents that are works in progress can be ignored during release builds.
- Blogging support, including multiple categories and tags.
- Beautified HTML documents.
- Optional cache busting of website assets during release builds (v1.2.0).
- Conditional composition of includes based on build strategy (v1.2.0).
- Reporting of works in progress during release builds (v1.2.0).
- Blog metadata exposed as simple tokens (v1.2.0).
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 prevents 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..
Show Your Appreciation
Please 👀 watch and leave us a 🌟 star. :)