UI to help you build and document web components.
Latest commit b5c97b1 Dec 2, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Rewrite json() and html() calls Jun 7, 2018
docs Fix get started guide #27 Nov 15, 2018
src Update normalize-url Nov 11, 2018
test Update normalize-url Nov 11, 2018
.gitignore Ignore `yarn.lock` and `package-lock.json` files Aug 8, 2017
.travis.yml Test windows using travis Oct 28, 2018
CHANGELOG.md Updated changelog Nov 15, 2018
LICENSE Copyright year Jan 22, 2018
README.md Changed video title Dec 2, 2018
package.json 5.1.1 Nov 15, 2018

README.md

Malvid

Travis Build Status Coverage Status Dependencies Greenkeeper badge

UI to help you build and document web components.

Malvid UI in a browser

Contents

Get started

Guide

Malvid can be integrated into your project in two ways: Using the CLI or using the API of Malvid. Check out our guide for more information. Get started with Malvid »

Demo

The website of Malvid is open-source and built entirely with Malvid. You can take a look at the components and how they are made in the repository of the website.

Introduction

What is Malvid?

Malvid helps you to build, document and visualise components by turning a directory into an interactive UI.

How does it work?

  1. You execute Malvid using the CLI or using the API
  2. Malvid scans the folder you've specified and generates a static HTML output
  3. You open the output in your browser to start browsing through your components

Why Malvid?

  • It visualises components in a way that improves how your team works with components
  • It doesn't force you to use a defined directory structure, templating language or build tool
  • It integrates perfectly with Rosid
  • It's built on popular modules like React
  • It's lightweight and only includes what it really needs

What are components?

Components are independent and reusable pieces of a project. A component could be a tiny chunk of HTML, a whole page or something in between. Malvid does not enforce any specific templating engine or naming conventions for those components.

Links

Boilerplates:

  • 📐 Skeleton Components: UI for components written in Nunjucks, JS (with Babel, UglifyJS) and SASS (with cssnano, Autoprefixer)

Guides:

Videos:

Similar tools:

Sites powered by Malvid:

Documentation

Requirements

Malvid depends on...

Make sure to install and update all dependencies before you setup Malvid.

Interface

The interface of Malvid puts the focus on your components. This chapter gives you an overview about it's possibilities. Interface »

Hotkeys

Navigate through your components using the hotkeys provided by Malvid. Hotkeys »

API

Malvid can be integrated into your project using its API or CLI. The API gives you more flexibility and allows you to use Malvid in your existing asset pipeline or toolset. API »

CLI

The CLI of Malvid is located in the bin folder and allows you to run Malvid without adding JS files to your project. This approach is simpler than using the API, but provides less flexibility. CLI »

Components

Malvid scans folders and detects all components in the given structure. This chapter explains how to store and manage components and how to add additional information to the UI using a configuration file. Components »

Integrations

The API of Malvid allows you to use your existing asset pipeline or toolset together with Malvid. This includes Rosid, Gulp, NPM scripts and other systems. Integrations »

Options

If you want more control over Malvid, pass an object of options to it. Options »

FAQ

Answers to frequently asked questions. FAQ »