Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pattern-lab/patternlab-node
The Node version of Pattern Lab
https://github.com/pattern-lab/patternlab-node
atomic-design design-systems hacktoberfest javascript nodejs pattern-lab
Last synced: 7 days ago
JSON representation
The Node version of Pattern Lab
- Host: GitHub
- URL: https://github.com/pattern-lab/patternlab-node
- Owner: pattern-lab
- License: mit
- Created: 2013-10-25T02:07:41.000Z (over 11 years ago)
- Default Branch: dev
- Last Pushed: 2024-05-21T19:22:49.000Z (9 months ago)
- Last Synced: 2025-01-28T09:34:40.120Z (14 days ago)
- Topics: atomic-design, design-systems, hacktoberfest, javascript, nodejs, pattern-lab
- Language: JavaScript
- Homepage: http://patternlab.io
- Size: 25.7 MB
- Stars: 2,061
- Watchers: 73
- Forks: 407
- Open Issues: 67
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- component-based-theming - Pattern Lab Node
- awesome-starred - pattern-lab/patternlab-node - The Node version of Pattern Lab (nodejs)
README
# Pattern Lab
This monorepo contains the core of Pattern Lab / Node and all related engines, UI kits, plugins, and utilities. Pattern Lab helps you and your team build thoughtful, pattern-driven user interfaces using atomic design principles.
If you'd like to see what a front-end project built with Pattern Lab looks like, check out this [online demo of Pattern Lab output](https://demo.patternlab.io/).
[](https://github.com/pattern-lab/patternlab-node/actions/workflows/continuous-integration.yml)
[](https://github.com/pattern-lab/patternlab-node/actions/workflows/codeql-analysis.yml)
[](https://coveralls.io/github/pattern-lab/patternlab-node?branch=master)
[](https://github.com/prettier/prettier)
[]()
[](https://gitter.im/pattern-lab/node)
[](https://discord.gg/UcZrYYE7ht)
Docs @ [](https://app.netlify.com/sites/patternlab-docs-preview/deploys)
Pattern Lab Preview @ [](https://app.netlify.com/sites/patternlab-handlebars-preview/deploys)
## Using Pattern Lab
Refer to the [core usage guidelines](https://github.com/pattern-lab/patternlab-node/blob/master/packages/core/README.md#usage)
### Installation
As of Pattern Lab Node 3.0.0, installation of [Editions](https://patternlab.io/docs/overview-of-pattern-lab's-ecosystem/) is accomplished via the command line interface.
The below assumes a new directory and project is required. This is likely what you want to do if starting from scratch. You could also run this within an existing project. The CLI will ask you for the installation location.
1. Open a terminal window and follow along below:
```bash
mkdir new-project
cd new-project
npm create pattern-lab
```
> If you get an error stating that `npx` is not installed, ensure you are on `npm 5.2.0` or later by running `npm -v` or install it globally with `npm install -g npx`. [Learn more about npx.](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b)
1. Follow the on-screen prompts to choose your Edition and a Starter Kit should you want one.
- If you chose `edition-node`, new commands in the "scripts" will be added to your `package.json`.
- If you chose `edition-node-gulp`, a `gulpfile.js` will be added to your project.
> Notice that `@pattern-lab/cli` was installed as a dependency. Learn how to further [use the cli in your own project](https://github.com/pattern-lab/patternlab-node/blob/dev/packages/cli/readme.md#configuring-your-project-to-use-the-cli).
## Ecosystem
Core, and Editions, are part of the [Pattern Lab Ecosystem](https://patternlab.io/docs/overview-of-pattern-lab's-ecosystem/). With this architecture, we encourage people to write and maintain their own Editions, Starter kits, and even PatternEngines.
## Changelog
[Each package within this monorepo](https://github.com/pattern-lab/patternlab-node/tree/master/packages) has its own changelog. Below are the main ones to watch:
* [@pattern-lab/core changelog ](https://github.com/pattern-lab/patternlab-node/blob/master/packages/core/CHANGELOG.md)
* [@pattern-lab/cli changelog ](https://github.com/pattern-lab/patternlab-node/blob/master/packages/cli/CHANGELOG.md)
## Support for Pattern Lab
Pattern Lab / Node wouldn't be what it is today without the support of the community. It will always be free and open source. Continued development is made possible in part from the support of [contributors](https://github.com/pattern-lab/patternlab-node/graphs/contributors).
Thanks to [Netlify](https://www.netlify.com/) for building tooling and hosting.
## Node Support Policy
We only support actively [maintained](https://github.com/nodejs/Release#release-schedule) versions of Node.
We specifically limit our support to maintenance versions of Node, not because this package won't work on other versions, but because we have a limited amount of time, and supporting the oldest maintenance offers the greatest return on that investment while still providing the lowest standard level for installations on any possible actively maintained environment out there.
This package may work correctly on newer versions of Node. It may even be possible to use this package on older versions of Node. However, that's more unlikely as we'll make every effort to take advantage of features available in the oldest maintenance Node version we support.
As each Node maintenance version reaches its end-of-life, we will replace that version from the `node` `engines` property of our package's `package.json` file with the newer oldest one. As this replacement would be considered a breaking change, we will publish a new major version of this package. We will not accept any requests to support an end-of-life version of Node. Any merge requests or issues supporting an end-of-life version of Node will be closed.
And we might even update the minor and patch version of that supported maintenance Node version regularly, without making this a breaking change than as it should be in everybody's interest even also to follow this concept of using patched software as their development system basis, especially on those older Node versions.
We will accept code that allows this package to run on newer, non-maintenance versions of Node. Furthermore, we will attempt to ensure our changes work on the latest version of Node. To help in that commitment, we even test that out by ourselves and get feedback from the community regularly regarding all LTS versions of Node and the most recent Node release called current.
JavaScript package managers like e.g. [NVM](https://github.com/nvm-sh/nvm) should allow you to install this package with any version of Node, with, at most, a warning if your version of Node does not fall within the range specified by our `node` `engines` property. If you encounter issues installing this package, please report the issue to your package manager.
This policy has been adapted from .
## Contributing
Refer to the [contribution guidelines](https://github.com/pattern-lab/patternlab-node/blob/master/.github/CONTRIBUTING.md).