Skip to content

Commit cc27d1d

Browse files
Update README.md
1 parent d724d08 commit cc27d1d

File tree

1 file changed

+43
-13
lines changed

1 file changed

+43
-13
lines changed

README.md

Lines changed: 43 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,54 @@
1-
# README
1+
This is the repo [for the docs](https://phlexyui.com/) of PhlexyUI, a Ruby UI component library for DaisyUI using Phlex ✨
22

3-
This README would normally document whatever steps are necessary to get the
4-
application up and running.
3+
# 🔧 Development
54

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.
76

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.
98

10-
* System dependencies
9+
2. Implement it.
1110

12-
* Configuration
11+
3. After your PR is merged, add it to this repo. You can use the generators to make your life easier:
1312

14-
* Database creation
13+
**New component**
1514

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.
1716

18-
* How to run the test suite
17+
e.g. `bin/rails generate example_view Card`
1918

20-
* Services (job queues, cache servers, search engines, etc.)
19+
This will create:
2120

22-
* Deployment instructions
21+
- app/views/examples/cards/show_view.rb
22+
- app/views/components/examples/cards/basic_component.rb
2323

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

Comments
 (0)