ghost-design-system

Ghost Design System - React Components library

Demo

Available components:

• Atoms:
  • Badge (notification and indicator)
  • Colors
  • Icons
  • Layout
    • Row
    • Col
    • Collapsable section
  • Link
  • Modal
  • Portal
  • Pulsar
  • Tooltip
  • Typography
    • Text
    • Title
• Molecules:
  • Amount field
  • Button
  • Checkbox field
  • Datepicker field
  • File field
  • Percentage field
  • Popover
  • Rich Text field
  • Select field:
    • Single
    • Multi
    • Autocomplete (aka Dynamic Search)
    • Autocomplete creatable (aka Dynamic Search Creatable)
  • Switch field
  • Textarea field
  • Text field
  • YearPicker field
• Organisms:
  • ActionBar
  • Datatable:
    • Editable Data Table (full editable)
    • Line editable Data Table (editon in popup form with data validation)
    • Line editable in place data table (edition of a line in place)
    • Static data table
  • Filter
  • Form:
    • Form component
    • useForm hook
  • NavBar
  • SideBar

Usage

• Run the command:

npm install ghost-design-system

• Define the set of colors by copying the file: ~ghost-design-system/dist/assets/_colors.scss)

// Neutral pallet
$chalk: rgb(228, 228, 228);
$charcoal: rgb(51, 51, 51);
$pebble: rgb(117, 117, 117);
$silver: rgb(196, 196, 196);
$smoke: rgb(248, 248, 248);
$white: rgb(255, 255, 255);

// Additional pallet
$scooter: rgb(38, 186, 212);
$buttercup: rgb(244, 174, 38);
$cerulean: rgb(1, 82, 129);
$cinnabar: rgb(232, 61, 71);
$fern: rgb(92, 184, 92);
$sky: rgb(16, 156, 241);
$tangerine: rgb(229, 114, 0);

$error: rgb(255, 52, 24);

$primary: $scooter;
$secondary: $pebble;
$tertiary: $charcoal;

$fontfamily: 'Montserrat', sans-serif;

• Create your index.scss file by starting it with:

@import 'colors.scss';
@import '~ghost-design-system/dist/assets/_global.scss';
@import '~ghost-design-system/dist/assets/_general.scss'; // Optional

• You should be ready to use any of the components of the library.

References

This react components library uses the following:

• @fortawesome
• @szhsin/react-menu
• classnames
• color-alpha
• color-rgba
• date-fns
• lodash
• numeral
• react-datepicker
• react-number-format
• react-select
• suneditor
• tippyjs
• yup

Peer dependencies:

• react
• react-dom
• suneditor - for SCSS import
• tippyjs - for SCSS import

Dev dependencies:

• ESLint
• Jest
• Prettier
• Rollup
• SCSS
• Storybook
• Testing-library
• Typescript

To go further

Basic Folder Structure

├── .storybook
├── src
│   ├── Components
|   |   ├── Atoms
|   |   |   ├── Example
|   |   |   |   ├── __tests__
|   |   |   |   |   ├── Example.test.tsx
|   |   |   |   ├── Example.stories.mdx
|   |   |   |   ├── Example.tsx
|   |   |   |   ├── index.ts
|   |   |   ├── index.ts
|   |   ├── index.ts
|   ├── index.ts
├── LICENSE
├── package.json
├── README.md

Once you have created your new component make sure you have exported it in the src/components/index.ts file. Doing so allows the component to be compiled.

// src/components/index.ts
export \* from './MyComponent';
export \* from './SomeOtherComponent';

You can develop your new component using storybook as your playground. Once you have added the .stories.tsx file for you new component, you can run yarn storybook to start the service.

Tests

$ npm run test

Watch

$ npm run test:watch

Coverage

$ npm run test:coverage

Prettier

$ npm run format

Validate project formatting

$ npm run format:check

Lint

$ npm run lint

Fix

$ npm run lint:fix

Storybook

$ npm run storybook

Build storybook

$ npm run build-storybook

Building your library

$ npm run build

The build output will go into the dist directory

Type

Must be one of the following:

• build: Changes that affect the build system or external dependencies (this correlates with PATCH in semantic versioning)
• ci: Changes to our CI configuration files and scripts (no version changes)
• docs: Documentation only changes (no version changes)
• feat: A new feature (this correlates with MINOR in semantic versioning).
• fix: A bug fix (this correlates with PATCH in semantic versioning).
• perf: A code change that improves performance (this correlates with PATCH in semantic versioning).
• refactor: A code change that neither fixes a bug nor adds a feature (no version changes)
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semicolons, etc) (no version changes)
• test: Adding missing tests or correcting existing tests (no version changes)
• revert: Reverts a previous commit (this correlates with PATCH in semantic versioning).

Description

The Description contains a succinct description of the change:

• use the imperative, present tense: "change" not "changed" nor "changes"
• don't capitalize the first letter
• no dot (.) at the end

Body (optional)

Use the imperative, present tense: "change" not "changed" nor "changes". The body should include the motivation for the change and contrast this with previous behavior.

Footer (optional)

The footer should contain any information about Breaking Changes and is also the place to reference issues that this commit Closes.

Breaking Changes

A commit that has the text BREAKING CHANGE: at the beginning of its optional body or footer section introduces a breaking API change (correlating with MAJOR in semantic versioning). A BREAKING CHANGE can be part of commits of any type.

should start with the word BREAKING CHANGE: with a space or two newlines. The rest of the commit message is then used for this.

Revert

If the commit reverts a previous commit, it should begin with revert: , followed by the header of the reverted commit. In the body it should say: This reverts commit <hash>., where the hash is the SHA of the commit being reverted.

Examples

see examples

Changelog

The changelog.md is automatically generated from the following types of commits:

• feat
• fix
• perf
• revert

In addition to these types, any breaking change will also be added to the changelog.