KeepReact

An open-source component library built on Tailwind CSS and React.js

Component ToolkitTailwindCSSReact
StaticMania/keep-reactreact.keepdesign.iokeep-react

README

KEEP REACT


Keep React is an open-source component library built on Tailwind CSS and React.js. It provides a versatile set of pre-designed UI components that enable developers to streamline the creation of modern, responsive, and visually appealing web applications.

Keep React

Installation


Vite React Application


After creating a React application with Vite, follow these steps to
install Keep React:

Step 1: Install Tailwind CSS

  1. ```console
  2. npm i autoprefixer postcss tailwindcss
  3. npx tailwindcss init -p
  4. ```

Step 2: Install Keep React:

  1. ```console
  2. npm i keep-react
  3. ```

Or with Yarn

  1. ```console
  2. yarn add keep-react
  3. ```

Or with Pnpm

  1. ```console
  2. pnpm add keep-react
  3. ```

Step 3: Go to the tailwind.config.js file and paste the
following code:

  1. ```jsx
  2. import keepPreset from "keep-react/src/keep-preset.js";
  3. export default {
  4.   content: ["node_modules/keep-react/**/*.{js,jsx,ts,tsx}"],
  5.   presets: [keepPreset],
  6. }
  7. ```

Step 4: Add Tailwind CSS to index.css File:

  1. ```css
  2. @import "keep-react/src/main.min.css";
  3. @tailwind base;
  4. @tailwind components;
  5. @tailwind utilities;
  6. ```

Next JS Application


You can easily integrate keep-react into your Next.js application. Starting from Next.js version 13.4, the app router automatically installs Tailwind CSS, eliminating the need for a separate Tailwind CSS installation. If you have already installed Tailwind CSS as part of the Next.js application setup, you can proceed with Step 2. Otherwise, start with Step 1.

After creating a Next JS application, follow these steps to
install Keep React:

Step 1: Install Tailwind CSS

  1. ```console
  2. npm i autoprefixer postcss tailwindcss
  3. npx tailwindcss init -p
  4. ```

Step 2: Install Keep React

  1. ```console
  2. npm i keep-react
  3. ```

Or with Yarn

  1. ```console
  2. yarn add keep-react
  3. ```

Or with Pnpm

  1. ```console
  2. pnpm add keep-react
  3. ```

Step 3: Go to the tailwind.config.js file and paste the
following code

  1. ```js
  2. module.exports = {
  3.     content: ["node_modules/keep-react/**/*.{js,jsx,ts,tsx}"],
  4.     presets: [require("keep-react/src/keep-preset.js")],
  5. };
  6. ```

Step 4: Add Tailwind CSS to globals.css File:

  1. ```css
  2. @import "keep-react/src/main.min.css";
  3. @tailwind base;
  4. @tailwind components;
  5. @tailwind utilities;
  6. ```

Congratulations! You have successfully installed the Keep React. Now you can import any component from keep-react and use it in your project.

usage


  1. ```jsx
  2. 'use client';
  3. import { Button } from "keep-react";
  4.   const App = () => {
  5.     return (
  6.       <Button size="md">Default</Button>
  7.     )
  8.   }
  9. export default App;
  10. ```

Components


The Keep React offers a wide range of components to build your user interfaces. For detailed usage and examples of each component, refer to our component documentation.

Contributing


If you want to contribute to the Keep React, you can follow the contributing guide.

Figma


If you need access to Figma design files for the components, you can check out our website for more information:

Get access to the Figma design files

License


The Keep-React name and logos are trademarks of StaticMania.

Read about the licensing terms