mediamonks / muban

A backend-agnostic framework to enhance server-rendered HTML using a modern webpack development setup.
https://mediamonks.github.io/muban/
39 stars 15 forks source link
boilerplate frontend-webdevelopment handlebars webpack

:no_entry: [DEPRECATED] Muban muban-release-status

:warning: This version will not receive any future updates, there is a new version

The muban repository and muban-core package will not receive any future updates.

There is a new version in active development at github.com/mubanjs (also called v2), with modern features and a full ecosystem for storybook, testing, hooks, etc.

Muban is a backend-agnostic framework and development setup to enhance server-rendered HTML with TypeScript or Babel components and SCSS stylesheets.

During development, webpack will supply fast compilation and hot reloading, while using Handlebars templates to render everything.

The dist build will generates preview html pages and a js and css bundle that backend developers can use to integrate the pages in their server side templates or CMS of choice.

šŸŽ“ Documentation

You can find the full documentation in the /docs folder. Here you will find the full table of contents covering all the subjects required to start on your own Muban project!

šŸš€ Quick start

If you have all the preparations done and you don't want to read the documentation you can follow these steps to get you started.

  1. Get the a copy of the source code using one of the following methods
    • Clone the repository and remove the .git folder.
    • šŸ“¦ Download the repository zip file.
  2. Install the project dependencies using yarn.
  3. Startup the development server using yarn dev.
  4. Start editing!

Note: If you need more instructions we suggest you take a look at the full getting started guide!

šŸ“š Ecosystem

Project Status Description
muban-core muban-core-status The core functionality of Muban
muban-storybook muban-storybook-status App framework to integrate Muban in Storybook
muban-storybook-addon-source muban-storybook-addon-source-status Show Muban component sources in Storybook
muban-transition-component ![muban-transition-component-status] GSAP transitions for Muban

šŸ“ License

Muban is released under the MIT License.

[muban-transition-component-status]: https://img.shields.io/npm/v/muban-transition-component.svg?colorB=41a6ff