npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@programmer_network/yail

v1.0.200

Published

Programmer Network's official UI library for React

Downloads

593

Readme

Yail

lint-and-test-pr

🎨Yail's Storybook

Yail is the official UI library of Programmer Network, crafted for developers who prioritize simplicity and efficiency. Embracing a minimalist approach, Yail is now open-sourced to share its straightforward and effective design ethos with the broader community. Here’s what makes Yail stand out:

  • Minimalistic Design: Yail focuses on the essentials to deliver a user-friendly experience free from unnecessary complexity.
  • Tailored with Tailwind-CSS: Integrating Tailwind-CSS, Yail offers intuitive styling options, enabling you to create visually appealing web projects effortlessly.
  • Ease of Maintenance: We prioritize hassle-free maintenance, making Yail as easy to manage as it is to implement.

Originally developed for Programmer Network, we decided to open source Yail due to the growing interest from the community. Whether you're working on small-scale projects or large applications, Yail provides the tools for building elegant, responsive, and accessible UIs with minimal overhead.

For an in-depth look at what Yail offers, the Storybook is a good starting point. It documents the current set of UI components and their usage patterns. You can visit our 🖌️Storybook to review the implemented features and components.

Yail is yet another interface library used by Programmer Network 💻🤓.

Prerequisites

Before you begin, ensure you have met the following requirements:

  • Node.js: Use nvm to switch to the version specified in the .nvmrc file. To ensure you're using the correct version of Node.js for this project, run nvm use in the project directory.
  • pnpm: Install pnpm globally with npm install -g pnpm.

Getting Started

Usage

Installation

To integrate Yail into your project, install it using your preferred package manager. For example, with pnpm, you can add it as follows:

pnpm add @programmer_network/yail

Incorporating Components into Your Project

After installation, you can start using Yail components in your React project.

To ensure proper styling with Tailwind CSS, include the CSS file generated by Yail in your project.

@import "@programmer_network/yail/dist/style.css";

Here's how you can import a component:

import { Button } from "@programmer_network/yail";

Exploring Components with Storybook

Yail provides a comprehensive component showcase through Storybook. To explore these components, start the Storybook server:

pnpm storybook

Contributing to Yail

We welcome contributions to Yail! Here's how you can set up the project locally for development.

Setting Up the Development Environment

Clone the Repository

First, clone the repository to your local machine:

git clone https://github.com/Programmer-Network/yail.git
cd yail

Install Dependencies

Use pnpm to install all necessary dependencies:

pnpm install

Running the Development Server

To start the development server, run:

pnpm dev

This command will launch Vite's development server. You can then make changes to the library, and Vite will automatically reload these changes.

View your changes inside storybook:

pnpm storybook

Running Tests

Yail uses Vitest for testing. To run tests, use the following commands:

Run all tests:

pnpm test

Run tests in watch mode:

pnpm test:watch

Linting and Code Formatting

To ensure code consistency, we use ESLint and Prettier. Run these before committing your changes:

To lint your code:

pnpm lint:fix

To format your code:

pnpm format

Creating a Pull Request

Once you've made your changes:

  1. Fork the repository.
  2. Create a new branch for your changes.
  3. Commit your changes and push them to your fork.
  4. Open a pull request against the master branch of the Programmer-Network/yail repository.

Please provide a clear description of the changes in your pull request.

Thank you for contributing to Yail!