Skip to content

Commit

Permalink
Feature/1 doc (#5)
Browse files Browse the repository at this point in the history
  • Loading branch information
michael-yin authored Jun 3, 2024
1 parent bc71444 commit 5756308
Show file tree
Hide file tree
Showing 2 changed files with 29 additions and 0 deletions.
Binary file added .github/assets/params-editor.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 29 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,32 @@
</div>

![Django Lookbook UI](.github/assets/lookbook_ui.png)

## Features

- Auto-detect and render the previews
- Filter previews in real-time
- Draggable and resizable layout
- Auto extract documentation from the preview doc string
- Powerful parameter editor, which allows the user to check UI in real-time (for example: change button text and color)
- This app is **pluggable** and can be integrated with any Django project

## Techs

This project is a reusable Django app that uses the following technologies:

1. Tailwind CSS for styling
2. Stimulus JS for interactivity
3. django-viewcomponent for preview discovery and rendering

## Storybook Controls

> Storybook Controls gives you a graphical UI to interact with a component's arguments dynamically without needing to code. It creates an addon panel next to your component examples ("stories"), so you can edit them live.
django-lookbook provides simple way to let developer use classic Django form to add `Params Editor` to the preview, which allow user to interact with the preview in real-time.

![Params Editor](.github/assets/params-editor.gif)

## Special Thanks

This project is heavily inspired by [lookbook](https://github.com/lookbook-hq/lookbook) from the Rails community.

0 comments on commit 5756308

Please sign in to comment.