The project is in a healthy, maintained state
ViewComponents for Polaris Design System
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 5.0.0
>= 3.0.0, < 4.0.0
 Project Readme

Polaris ViewComponents

Polaris ViewComponents is an implementation of the Polaris Design System using ViewComponent.

Polaris ViewComponents

Preview

https://polarisviewcomponents.org

Usage

Render Polaris ViewComponents:

<%= polaris_card(title: "Title") do %>
  <p>Card example</p>
<% end %>

Dependencies

Installation

Add polaris_view_components to your Gemfile:

bundle add polaris_view_components

Run installer:

bin/rails polaris_view_components:install

Upgrade

Check out UPGRADING.md for upgrade instructions.

Development

To get started:

  1. Run: bundle install
  2. Run: yarn install
  3. Run: bin/dev

It will open demo app with component previews on localhost:4000. You can change components and they will be updated on page reload. Component previews located in demo/test/components/previews.

To run tests:

rake

Releases

The library follows semantic versioning. To draft a new release you need to run bin/release with a new version number:

bin/release VERSION

Where the VERSION is the version number you want to release. This script will update the version in the gem and push it to GitHub and Rubygems automatically.

To release a new version of npm package update the package.json file with the new version number and run:

npm run release

After that make sure to commit changes in package.json.

License

The gem is available as open source under the terms of the MIT License.