https://github.com/ClickHouse/click-ui

The home of the ClickHouse design system and component library.
https://github.com/ClickHouse/click-ui

Last synced: about 2 months ago
JSON representation

The home of the ClickHouse design system and component library.

• Host: GitHub
• URL: https://github.com/ClickHouse/click-ui
• Owner: ClickHouse
• Created: 2023-03-17T18:47:19.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-22T17:42:37.000Z (7 months ago)
• Last Synced: 2024-05-23T06:40:53.221Z (7 months ago)
• Language: TypeScript
• Homepage: https://click-ui.vercel.app
• Size: 5.2 MB
• Stars: 64
• Watchers: 30
• Forks: 4
• Open Issues: 20
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-clickhouse - ClickHouse/click-ui - Click UI is a design system and component library for ClickHouse, aimed at providing UI components for application development. (UIs / GUI)

README

        
# Click UI

The home of the ClickHouse design system and component library. Click UI is in very early development and subject to change, we do not recommend using it for production purposes.

### Using Click UI in an external app

Click UI has been tested in NextJS, Gatsby, and Vite. If you run into problems using it in your app, please create an issue and our team will try to answer.

1. Navigate to your app's route and run

   `npm i @clickhouse/click-ui`

   or

   `yarn add @clickhouse/click-ui`

2. Make sure to wrap your application in the Click UI `ClickUIProvider`, without doing this, you may run into issues with styled-components. Once thats done, you'll be able to import the individual components that you want to use on each page. Here's an example an `App.tsx` in NextJS.

```ts

import { ClickUIProvider, Text, ThemeName, Title, Switch } from '@clickhouse/click-ui'

function App() {

  const [theme, setTheme] = useState('dark')

  const toggleTheme = () => {

    theme === 'dark' ? setTheme('light') : setTheme('dark')

  }

  return (

    

       toggleTheme() } />

      Click UI Example

      Welcome to Click UI. Get started here.

    

  )

}

export default App

```

### To develop this library locally 🚀

1. Clone this repo, cd into the `click-ui` directory

2. To install dependencies, run `npm i`

3. To build the latest styles, run `npm run generate-tokens`

4. To run ClickUI locally, run `npm run dev` and navigate to http://localhost:5173

5. To run Storybook locally, run `npm run storybook` and navigate to https://localhost:6006

Enjoy!