Skip to content

Latest commit

 

History

History
159 lines (110 loc) · 8.58 KB

README.md

File metadata and controls

159 lines (110 loc) · 8.58 KB

Solid JS JavaScript Typescript Tailwind Jest HTML5 Vite NPM Vercel

Solibee is an open-source collection of accessible and customizable components for Solid JS.
Check out our website www.solibee.dev!
Package Manager NPM Solibee

About

NPM Version
Table of Contents

Features

  • Easy to use: To get started with Solibee please visit our documentation for user-friendly customizable component previews and installation guides. Installation guides also available here.
  • Customizable: All Solibee components are built using Solid JS and styled with Tailwind CSS which ensures that each component is easily customizable to fit the design and needs of your project.
  • Accessible: Solibee component library is designed with accessibility in mind to ensure that all our users can interact with the components. Our components follow WAI-ARIA design patterns.
  • Documented: Comprehensive documentation provided for each component to facilitate easy usage and understanding.
  • Reliable: Solibee custom components are written in JavaScript or TypeScript and tested with Jest and Solid JS Testing library.
  • Opportunities to contribute: Solibee is an open-source project built for the Solid JS community. If you have any questions, feedback, or suggestions, please scroll down for instructions on how to contribute to this project.

Getting Started

CLI Installation

Solibee provides a CLI to help you get started quickly. To use a component in your project please follow the steps below:

  1. Run the following command in your terminal. Substitute ComponentName with the name of the custom component you would like to use. You can see the preview and the full list of components here.
  npx solibee create-[ComponentName]
  1. When you run the CLI command above it will automatically install all dev dependencies.

  2. After successful installation you will find a new Solibee directory created in your root folder. This directory will contain a CustomComponent, Tailwind.config, PostCSS.config files.

  3. Configure dev dependencies:

    • If you don't have Tailwind.config and PostCSS.config files in the root directory, bring Tailwind.config and PostCSS.config files from Solibee directory to your root directory.
    • If you have existing Tailwind.config and PostCSS.config files in your root directory, integrate Tailwind and PostCSS configurations installed with Solibee.
  4. Configure Tailwind styles
    Add the following to your global CSS styles file.

  @tailwind base;
  @tailwind components;
  @tailwind utilities;
  1. You're ready to go!

Manual Installation

  1. Install Dev Dependencies
    Our components are styled using Tailwind CSS. You need to install four dev dependencies in your project.
  npm install --save-dev tailwind
  npm install --save-dev postcss
  npm install --save-dev @tailwindcss/forms
  npm install --save-dev autoprefixer
  1. Configure a tailwind.config.js file
    To see the Tailwind config file follow this link

  2. Configure Tailwind styles
    Add the following to your global CSS styles file.

  @tailwind base;
  @tailwind components;
  @tailwind utilities;
  1. Copy the code for the custom component you chose here. Create a file in your working directory and paste the code you copied.

  2. You're ready to go!

Testing

Solibee component library was built with testing in mind. Testing is done with Jest and Solid JS Testing Library. Testing has been implemented on 100% of custom components. Currently, all tests for the custom components exist in this repository. You can find them in the src/__test__ directory. We would love to see CLI installation for testing files in the future.

test-coverage

How To Contribute

Solibee is an open-source project built for the Solid JS community maintained by OS Labs. We welcome contributions and feedback from the community to make Solibee even better as there's so much room to grow. For any major changes or updates, please open an issue first. Please make sure to update the tests as appropriate. Contribute to our project by following these simple steps:

  1. Fork this Repository
  2. Create your Feature Branch by following these naming conventions:
    • feat/[NewFeature]
    • fix/[NewFix]
    • docs/[NewDocs]
  3. Commit your changes
  4. Publish your branch
  5. Open a Pull Request to the DEV branch of this Repository

Known Issues

  • MORE COMPONENTS!
  • Some Solibee components are still in Beta
  • We would love to see CLI installation for testing files in the future
  • Continuing TypeScript Conversion: Currently, components in Solibee library are written either in JavaScript or TypeScript. We would like to see Solibee library to support both TypeScript and JavaScript for each custom component.

Meet The Team

  • Bongi Sibanda GitHub LinkedIn

  • Congke Zhao GitHub LinkedIn

  • Lillian Tenn GitHub LinkedIn

  • Marselena Sequoia GitHub LinkedIn

  • Neul Seo GitHub LinkedIn

License

Solibee is an open-source product licensed under the MIT License.