Blueprint ![CircleCI](https://camo.githubusercontent.com/3fcf7c8eb7653bcd1e8465d06857eafb479cb4f93b92b7794b4a53626b7a76ac/68747470733a2f2f636972636c6563692e636f6d2f67682f70616c616e7469722f626c75657072696e742f747265652f646576656c6f702e7376673f7374796c653d737667)
Blueprint is a React-based UI toolkit for the web.
It is optimized for building complex, data-dense web interfaces for desktop applications. If you rely heavily on mobile interactions and are looking for a mobile-first UI toolkit, this may not be for you.
Read the introductory blog post βΈ
View the full documentation βΈ
Bug report? Feature request? Support question?
Choose the appropriate issue type and fill out the template.
What's new in 2.0
Check out the 2.0 changelog on the wiki, and make sure to review the 2.0 migration guide.
π§ 3.0 is in progress! π§
Blueprint 3.0 will support multiple major versions of Blueprint on the same page through removing global styles and deconflicting selectors. It also restores support for React 15 in most packages.
To make a contribution that you wish to have released in an earlier major version of any @blueprintjs
package, please submit a PR to the release/1.x
or release/2.x
branch.
Packages
This repository contains multiple projects in the packages/
directory that fall into 3 categories:
Libraries
These are the component libraries we publish to NPM.
β Core styles & components.
β Components for interacting with dates and times.
β Components for generating and displaying icons.
β Components for selecting items from a list.
β Scalable interactive table component.
β Components for picking timezones.
β Incubator and staging area for new components still under initial development.
Applications
These are hosted on GitHub Pages as static web applications:
docs-app
β Documentation site at blueprintjs.com/docslanding-app
β Landing page at blueprintjs.com
These are used as development playground environments:
table-dev-app
β demo page that supports manual testing of all table features
Build tooling
These packages define development dependencies and contain build configuration. They adhere to the standard NPM package layout, which allows us to keep clear API boundaries for build configuration and isolate groups of devDependencies
. They are published to NPM in order to allow other Blueprint-related projects to use this infrastructure outside this monorepo.
β Documentation theme for Documentalist data.
Development
Lerna manages inter-package dependencies in this monorepo.
Builds are orchestrated via lerna run
and NPM scripts.
Prerequisites: Node.js v8+, Yarn v1.0+
One-time setup
After cloning this repo, run:
yarn
to install all dependencies.yarn verify
to ensure you have all the build tooling working properly.
Incorporating upstream changes
If you were previously in a working state and have just pulled new code from develop
:
- If there were package dependency changes, run
yarn
at the root.- This command is very quick if there are no new things to install.
- Run
yarn compile
to get the latest built versions of the library packages in this repo.- This command is quicker than
yarn verify
since it doesn't build the application packages (docs-app
,landing-app
, etc.) or run tests
- This command is quicker than
Developing libraries
Each library has its own dev script which you can run to watch changes to that package and run the docs application with webpack-dev-server: yarn dev:core
, yarn dev:datetime
, etc.
- One exception is
table
βsince it has its own dev application, thedev:table
script doesn't run the docs site.- Run the table dev application using
yarn dev
in the packages/table-dev-app folder.
- Run the table dev application using
- You may also choose to watch changes across all packages by running
yarn dev:all
from the root directory.
Updating dependencies
- Edit the
package.json
where you wish to change dependencies. - Run
yarn
at the root to update lockfiles. - Commit the result.
Updating documentation
Much of Blueprint's documentation lives inside source code as JSDoc comments in .tsx
files and KSS markup in .scss
files. This documentation is extracted and converted into static JSON data using documentalist.
If you are updating documentation sources (not the docs UI code which lives in packages/docs-app
or the docs theme in packages/docs-theme
), you'll need to run yarn compile
from packages/docs-data
to see changes reflected in the application. For simplicity, an alias script yarn docs-data
exists in the root to minimize directory hopping.
Updating icons
The One-time setup and Incorporating upstream changes steps should produce the generated source code in this repo used to build the icons documentation. This is sufficient for most development workflows.
If you are updating icons or adding new ones, you'll need to run yarn compile
in packages/icons
to see those changes reflected before
running any of the dev scripts.
Contributing
Looking for places to contribute to the codebase? Check out the "help wanted" label.
Read about our contribution guidelines and development practices to give your PR its best chance at getting merged.
License
This project is made available under the Apache-2.0 License.