|
1 |
| -# README |
| 1 | +This is the repo [for the docs](https://phlexyui.com/) of PhlexyUI, a Ruby UI component library for DaisyUI using Phlex ✨ |
2 | 2 |
|
3 |
| -This README would normally document whatever steps are necessary to get the |
4 |
| -application up and running. |
| 3 | +# 🔧 Development |
5 | 4 |
|
6 |
| -Things you may want to cover: |
| 5 | +After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` to run the tests. |
7 | 6 |
|
8 |
| -* Ruby version |
| 7 | +1. Visit [the docs](https://phlexyui.com/) to see which components are still not implemented or not yet added to the docs. |
9 | 8 |
|
10 |
| -* System dependencies |
| 9 | +2. Implement it. |
11 | 10 |
|
12 |
| -* Configuration |
| 11 | +3. After your PR is merged, add it to this repo. You can use the generators to make your life easier: |
13 | 12 |
|
14 |
| -* Database creation |
| 13 | +**New component** |
15 | 14 |
|
16 |
| -* Database initialization |
| 15 | +If you're adding a new component, use `bin/rails generate example_view`. This generates a new component example view and a basic component. |
17 | 16 |
|
18 |
| -* How to run the test suite |
| 17 | +e.g. `bin/rails generate example_view Card` |
19 | 18 |
|
20 |
| -* Services (job queues, cache servers, search engines, etc.) |
| 19 | +This will create: |
21 | 20 |
|
22 |
| -* Deployment instructions |
| 21 | +- app/views/examples/cards/show_view.rb |
| 22 | +- app/views/components/examples/cards/basic_component.rb |
23 | 23 |
|
24 |
| -* ... |
| 24 | +**New example** |
| 25 | + |
| 26 | +If you're adding a new example to an existing component, use `bin/rails generate example_component`. This generates a new component example. |
| 27 | + |
| 28 | +e.g. `bin/rails generate example_component Cards::Responsive "Optional title"` |
| 29 | + |
| 30 | +This will create: |
| 31 | + |
| 32 | +- app/views/components/examples/cards/responsive_component.rb |
| 33 | + |
| 34 | +4. Celebrate 🎉 |
| 35 | + |
| 36 | +# 💻 Contributing |
| 37 | + |
| 38 | +Bug reports and pull requests are welcome on GitHub at https://github.com/PhlexyUI/phlexy_ui. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/phlexy_ui/blob/main/CODE_OF_CONDUCT.md). |
| 39 | + |
| 40 | +1. Visit [the docs](https://phlexyui.com/) to see which components are still not implemented or not yet added to the docs. |
| 41 | + |
| 42 | +2. Implement it. |
| 43 | + |
| 44 | +3. After your PR is merged, [add it to the docs](https://github.com/PhlexyUI/phlexy_ui_docs). |
| 45 | + |
| 46 | +4. Celebrate 🎉 |
| 47 | + |
| 48 | +# 📃 License |
| 49 | + |
| 50 | +The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). |
| 51 | + |
| 52 | +# ☝️ Code of Conduct |
| 53 | + |
| 54 | +Everyone interacting in the PhlexyUI project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/phlexy_ui/blob/main/CODE_OF_CONDUCT.md). |
0 commit comments