Awesome
<p align="center"> <img alt="Pharos Design System" src="./readme_header.png" width="100%" /> </p> <h1 align="center"> Pharos Design System </h1>Pharos is JSTOR’s design system for creating cohesive, supportive and beautiful experiences for the intellectually curious.
<p align="center"> <a href=".github/CODE_OF_CONDUCT.md"><img src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg" alt="Contributor Covenant" /></a> <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Pharos is released under the MIT license" /></a> <a href="#contributors-"><img src="https://img.shields.io/github/all-contributors/ithaka/pharos?color=orange" alt="All Contributors" /></a> <a href="https://bundlephobia.com/package/@ithaka/pharos"><img src="https://img.shields.io/bundlephobia/min/@ithaka/pharos" alt="Bundlephobia stats" /></a> </p>JSTOR is a digital library for the intellectually curious. We provide a platform for discovering and connecting research, images, and primary sources. As a not-for-profit, we partner with libraries, museums, and publishers to reduce costs, extend access, and preserve scholarship for the future. We do this because we believe in the power of knowledge to change the world for the better.
Build statuses
| System | Status |
|---|---|
| Site | |
| Storybooks |
Getting Started
- Check out the core package for more info about Pharos components and how to get started
- Visit the Pharos site to learn about the JSTOR brand, design guidelines, and component usage guidelines
- Explore the web component Storybook or the React Storybook to try the live components
- Test for visual regressions in the Pharos Chromatic project
Packages and configuration
This repository contains a number of packages related to Pharos:
| Syntax | Description |
|---|---|
| @ithaka/pharos | Pharos Component library |
| @ithaka/pharos-cli | CLI tool for building Pharos components |
| @ithaka/pharos-site | Site & Documentation for Pharos |
In addition to these packages, this repository contains the configuration for Pharos Storybooks.
Contributing
If you'd like to learn more about contributing to Pharos, refer to the contribution guide.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://niznikr.github.io/"><img src="https://avatars.githubusercontent.com/u/2147624?v=4?s=100" width="100px;" alt="Robert Niznik"/><br /><sub><b>Robert Niznik</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=Niznikr" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/SMQuazi"><img src="https://avatars.githubusercontent.com/u/7356353?v=4?s=100" width="100px;" alt="Sayem Quazi"/><br /><sub><b>Sayem Quazi</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=SMQuazi" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://dane.engineering/"><img src="https://avatars.githubusercontent.com/u/1808306?v=4?s=100" width="100px;" alt="Dane Hillard"/><br /><sub><b>Dane Hillard</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=daneah" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbhakta"><img src="https://avatars.githubusercontent.com/u/4246209?v=4?s=100" width="100px;" alt="Jayshree Bhakta"/><br /><sub><b>Jayshree Bhakta</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=jbhakta" title="Tests">⚠️</a></td> <td align="center" valign="top" width="14.28%"><a href="https://evanslawski.com/"><img src="https://avatars.githubusercontent.com/u/3267412?v=4?s=100" width="100px;" alt="Evan Slawski"/><br /><sub><b>Evan Slawski</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=eslawski" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/kelseytrabue"><img src="https://avatars.githubusercontent.com/u/1484014?v=4?s=100" width="100px;" alt="Kelsey Cavitt"/><br /><sub><b>Kelsey Cavitt</b></sub></a><br /><a href="#design-kelseytrabue" title="Design">🎨</a> <a href="https://github.com/ithaka/pharos/commits?author=kelseytrabue" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/jialin-he"><img src="https://avatars.githubusercontent.com/u/38861633?v=4?s=100" width="100px;" alt="Jialin He"/><br /><sub><b>Jialin He</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=jialin-he" title="Code">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/michael-iden"><img src="https://avatars.githubusercontent.com/u/13315416?v=4?s=100" width="100px;" alt="Mike Iden"/><br /><sub><b>Mike Iden</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=michael-iden" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/ymouzakis"><img src="https://avatars.githubusercontent.com/u/64924035?v=4?s=100" width="100px;" alt="Yanni Mouzakis"/><br /><sub><b>Yanni Mouzakis</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=ymouzakis" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/kentjas1"><img src="https://avatars.githubusercontent.com/u/2760087?v=4?s=100" width="100px;" alt="Jay Kent"/><br /><sub><b>Jay Kent</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=kentjas1" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/seanggani"><img src="https://avatars.githubusercontent.com/u/60366518?v=4?s=100" width="100px;" alt="Sean Anggani"/><br /><sub><b>Sean Anggani</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=seanggani" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/rehanabbasi"><img src="https://avatars.githubusercontent.com/u/23479616?v=4?s=100" width="100px;" alt="Rehan Abbasi"/><br /><sub><b>Rehan Abbasi</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=rehanabbasi" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/seanmitchey"><img src="https://avatars.githubusercontent.com/u/3036959?v=4?s=100" width="100px;" alt="Sean Mitchey"/><br /><sub><b>Sean Mitchey</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=seanmitchey" title="Tests">⚠️</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/cameronheard"><img src="https://avatars.githubusercontent.com/u/3027683?v=4?s=100" width="100px;" alt="Cameron Heard"/><br /><sub><b>Cameron Heard</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=cameronheard" title="Tests">⚠️</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/aebankston"><img src="https://avatars.githubusercontent.com/u/4641137?v=4?s=100" width="100px;" alt="Aparna Bankston"/><br /><sub><b>Aparna Bankston</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=aebankston" title="Tests">⚠️</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Liza-Pagano"><img src="https://avatars.githubusercontent.com/u/64424406?v=4?s=100" width="100px;" alt="Liza-Pagano"/><br /><sub><b>Liza-Pagano</b></sub></a><br /><a href="#design-Liza-Pagano" title="Design">🎨</a> <a href="https://github.com/ithaka/pharos/commits?author=Liza-Pagano" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/lorilundy711"><img src="https://avatars.githubusercontent.com/u/80061918?v=4?s=100" width="100px;" alt="Lori Lundy"/><br /><sub><b>Lori Lundy</b></sub></a><br /><a href="#design-lorilundy711" title="Design">🎨</a> <a href="https://github.com/ithaka/pharos/commits?author=lorilundy711" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/fswlee"><img src="https://avatars.githubusercontent.com/u/5896534?v=4?s=100" width="100px;" alt="Florence Lee"/><br /><sub><b>Florence Lee</b></sub></a><br /><a href="#design-fswlee" title="Design">🎨</a> <a href="https://github.com/ithaka/pharos/commits?author=fswlee" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/jalex21"><img src="https://avatars.githubusercontent.com/u/64159876?v=4?s=100" width="100px;" alt="Justin Alexander"/><br /><sub><b>Justin Alexander</b></sub></a><br /><a href="#a11y-jalex21" title="Accessibility">️️️️♿️</a> <a href="https://github.com/ithaka/pharos/commits?author=jalex21" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/matomaton"><img src="https://avatars.githubusercontent.com/u/46448980?v=4?s=100" width="100px;" alt="Matthew Martin"/><br /><sub><b>Matthew Martin</b></sub></a><br /><a href="#design-matomaton" title="Design">🎨</a> <a href="https://github.com/ithaka/pharos/commits?author=matomaton" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Lham42"><img src="https://avatars.githubusercontent.com/u/32990373?v=4?s=100" width="100px;" alt="Elham Islam"/><br /><sub><b>Elham Islam</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=Lham42" title="Code">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/gbassham"><img src="https://avatars.githubusercontent.com/u/56835183?v=4?s=100" width="100px;" alt="Gayla Bassham"/><br /><sub><b>Gayla Bassham</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=gbassham" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/satya-achanta-venkata"><img src="https://avatars.githubusercontent.com/u/57365199?v=4?s=100" width="100px;" alt="Satya AchantaVenkata"/><br /><sub><b>Satya AchantaVenkata</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=satya-achanta-venkata" title="Code">💻</a> <a href="https://github.com/ithaka/pharos/commits?author=satya-achanta-venkata" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/facelessfool"><img src="https://avatars.githubusercontent.com/u/41726786?v=4?s=100" width="100px;" alt="K Chingsubam"/><br /><sub><b>K Chingsubam</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=facelessfool" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/chrisjbrown"><img src="https://avatars.githubusercontent.com/u/1250638?v=4?s=100" width="100px;" alt="Christopher Brown"/><br /><sub><b>Christopher Brown</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=chrisjbrown" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/JoshAtITHAKA"><img src="https://avatars.githubusercontent.com/u/59626212?v=4?s=100" width="100px;" alt="JoshAtITHAKA"/><br /><sub><b>JoshAtITHAKA</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=JoshAtITHAKA" title="Code">💻</a> <a href="https://github.com/ithaka/pharos/commits?author=JoshAtITHAKA" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/adandavati"><img src="https://avatars.githubusercontent.com/u/13627169?v=4?s=100" width="100px;" alt="Armaan Dandavati"/><br /><sub><b>Armaan Dandavati</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=adandavati" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/shoupeva-ithaka"><img src="https://avatars.githubusercontent.com/u/112417900?v=4?s=100" width="100px;" alt="Evan Shoup"/><br /><sub><b>Evan Shoup</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=shoupeva-ithaka" title="Code">💻</a> <a href="https://github.com/ithaka/pharos/commits?author=shoupeva-ithaka" title="Documentation">📖</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/drewgingerich"><img src="https://avatars.githubusercontent.com/u/15133892?v=4?s=100" width="100px;" alt="Drew Gingerich"/><br /><sub><b>Drew Gingerich</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=drewgingerich" title="Documentation">📖</a> <a href="https://github.com/ithaka/pharos/commits?author=drewgingerich" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/HassanTanveer"><img src="https://avatars.githubusercontent.com/u/57575219?v=4?s=100" width="100px;" alt="Hassan Tanveer"/><br /><sub><b>Hassan Tanveer</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=HassanTanveer" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/mariadevadoss"><img src="https://avatars.githubusercontent.com/u/132926833?v=4?s=100" width="100px;" alt="mariadevadoss"/><br /><sub><b>mariadevadoss</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=mariadevadoss" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://brentswisher.com/"><img src="https://avatars.githubusercontent.com/u/6653970?v=4?s=100" width="100px;" alt="Brent Swisher"/><br /><sub><b>Brent Swisher</b></sub></a><br /><a href="https://github.com/ithaka/pharos/issues?q=author%3Abrentswisher" title="Bug reports">🐛</a> <a href="https://github.com/ithaka/pharos/commits?author=brentswisher" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/henryclong"><img src="https://avatars.githubusercontent.com/u/52258386?v=4?s=100" width="100px;" alt="Henry Long"/><br /><sub><b>Henry Long</b></sub></a><br /><a href="https://github.com/ithaka/pharos/commits?author=henryclong" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://matharris.dev/"><img src="https://avatars.githubusercontent.com/u/6874453?v=4?s=100" width="100px;" alt="Mat Harris"/><br /><sub><b>Mat Harris</b></sub></a><br /><a href="#a11y-sirrah-tam" title="Accessibility">️️️️♿️</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/david-corneail"><img src="https://avatars.githubusercontent.com/u/104939119?v=4?s=100" width="100px;" alt="david-corneail"/><br /><sub><b>david-corneail</b></sub></a><br /><a href="#design-david-corneail" title="Design">🎨</a> <a href="https://github.com/ithaka/pharos/commits?author=david-corneail" title="Documentation">📖</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->This project follows the all-contributors specification. Contributions of any kind are welcome!
Work with us at ITHAKA
JSTOR is part of ITHAKA, a not-for-profit dedicated to expanding access to knowledge and education worldwide. Our staff makes us who we are. We’re hiring — join us!
License
This project is available under the MIT license. For more information, view the full license and copyright notice.
Copyright 2021 Ithaka Harbors, Inc.