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

@smitch/fluid

v1.1.0

Published

A React ui-component libray.

Downloads

2,837

Readme

Fluid UI

A Next.js/React UI component library.

Overview

Fluid UI is a comprehensive library of reusable UI components for Next.js/React applications. This library is designed to streamline the development process and ensure consistency across your projects.

Features

  • Reusable UI components
  • Built with React
  • Easy to integrate
  • Supports TypeScript
  • Storybook for component documentation

Getting Started

To use Fluid UI in your Next.js/React project, follow these steps:

1. Install Next.js and React

If you haven't set up your Next.js project yet, start by initializing it:

npx create-next-app@latest

When prompted:

  • Use TypeScript?: Select Yes to enable TypeScript in your project.
  • Use Tailwind CSS?: Select Yes to install and configure Tailwind CSS automatically.

Next.js will then generate the necessary configuration for both TypeScript and Tailwind CSS, including tsconfig.json, tailwind.config.js, and PostCSS setup.

2. Configure Tailwind

To ensure that Fluid UI works correctly, you need to configure Tailwind CSS and install the Tailwind Forms plugin. Follow the steps below:

1. Install Tailwind CSS Forms Plugin

You need to install the Tailwind CSS forms plugin for proper form styling:

npm install @tailwindcss/forms

2. Configure tailwind.config.js

Update your tailwind.config.js file to match the configuration below:

import type { Config } from 'tailwindcss'
/* Import colors if using Tailwind's color palette */
import colors from 'tailwindcss/colors'

const config: Config = {
    /* The selector strategy replaced the class strategy in Tailwind CSS v3.4.1.*/
	darkMode: 'selector',
	content: [
		'./src/pages/**/*.{js,ts,jsx,tsx,mdx}',
		'./src/components/**/*.{js,ts,jsx,tsx,mdx}',
		'./src/app/**/*.{js,ts,jsx,tsx,mdx}',
		/* Add this line: */
		 "./node_modules/@smitch/fluid/**/*.js",
	],
	theme: {
		extend: {
			colors: {
                /* Modify color values as desired to suit your theme */
				primary: {
					DEFAULT: colors.indigo[600],
					light: colors.indigo[300],
					dark: colors.indigo[900],
				},
				secondary: {
					DEFAULT: colors.gray[600],
					light: colors.gray[300],
					dark: colors.gray[900],
				},
				accent: {
					DEFAULT: colors.orange[500],
					light: colors.orange[300],
					dark: colors.orange[700],
				},
				neutral: colors.gray[400],
				dark: colors.gray[900],
				light: colors.gray[100],
				info: {
					DEFAULT: colors.sky[400],
					light: colors.sky[200],
					dark: colors.sky[600],
				},
				success: {
					DEFAULT: colors.green[600],
					light: colors.green[400],
					dark: colors.green[800],
				},
				warning: {
					DEFAULT: colors.amber[500],
					light: colors.amber[300],
					dark: colors.amber[700],
				},
				error: {
					DEFAULT: colors.red[600],
					light: colors.red[400],
					dark: colors.red[800],
				},
				danger: {
					DEFAULT: colors.red[600],
					light: colors.red[400],
					dark: colors.red[800],
				},
				current: 'currentColor',
				transparent: 'transparent',
			},
		},
	},
	plugins: [
        /* Tailwind Forms plugin for consistent form styling */
		require('@tailwindcss/forms')({
			strategy: 'class',
		}),
	],
}
export default config

Installation

npm install @smitch/fluid

Basic Usage

Now, you can import and use any Fluid UI component in your Next.js project:

import { Button } from '@smitch/fluid'

const App = () => (
  <Button>Click me</Button>
)

export default App

Components

Buttons

  • Button
  • Close Button
  • Button Group

Inputs

  • Checkbox
  • Counter
  • File Upload
  • Input
  • Password Input
  • Radio Group
  • Range Input
  • Search Input
  • Select
  • Switch
  • Textarea
  • Text Input

Forms

  • Fieldset
  • Form
  • Label

Menus

  • Accordion
  • Breadcrumbs
  • Carousel
  • Drawer
  • Dropdown
  • Pagination
  • Sidebar
  • Tabs

Feedback

  • Alert
  • Badge
  • Dialog
  • Loading
  • Progress
  • Ratings
  • Toast

Media

  • Card
  • Figure
  • Gallery
  • Hero
  • Modal
  • Twitter Embed
    • Twitter Timeline
  • Video
  • Video Player
  • YouTube Embed

Typography

  • Blockquote
  • Codeblock
  • Heading

Data Visualization

  • Data Table
  • Line Chart
  • Bar Chart
  • Pie Chart
  • Donut Chart

Author

Fluid UI is developed and maintained by Stephen Mitchell.