Skip to content

shellrent/shelly-ui

Repository files navigation

Shelly-UI

Logo Shelly UI

Shelly-UI is a lightweight and flexible component library developed by Shellret. This library is built entirely in TypeScript and leverages modern web development technologies such as Tailwind CSS, DaisyUI, and Headless UI to provide a powerful and easy-to-use solution for building user interfaces.

Installation

To install Shelly-UI in your project, run the following command:

npm install @shellrent/shelly-ui
# or
yarn add @shellrent/shelly-ui

Configuration

  1. Make shure you have installed https://tailwindcss.com/
  2. Edit the tailwind.config.js including shelly-ui files:
/** @type {import('tailwindcss').Config} */

export default {
	content: [
    // ...
		"./node_modules/shelly-ui/dist/**/*.{js,jsx,ts,tsx}"
	],
  // ...
	plugins: [require("daisyui")],
}
  1. To enable all the features of shelly wrap your application with ShellyProvider>
import React, { Suspense } from "react";
import { ShellyConfig, ShellyProvider } from '@shellrent/shelly-ui';
import Spinner from "./common/components/Spinner";
import App from "./App";

const config: ShellyConfig = {
	// ...your configuration
};

const Root: React.FC = () => {
	return <>
		<Suspense fallback={<Spinner />}>
			<ShellyProvider config={config}>
				<App/>
			</ShellyProvider>
		</Suspense >
	</>;
};

export default Root;

Usage

Import the desired components into your TypeScript application and start using them:

import { Button, Alert } from '@shellrent/shelly-ui';

// Use the components as needed
const MyComponent = () => {
  return (
    <div>
      <Button>Click me</Button>
      <Alert type="success">Operation completed successfully!</Alert>
    </div>
  );
};

Storybook

  • yarn
    • npm install
  • yarn storybook
  • accedi a storybook da http://192.168.56.99:6007, dove l'ip è quello della VM (o in alternativa localhost)