33 lines
2.1 KiB
Markdown
33 lines
2.1 KiB
Markdown
# Contributing to Halfmoon
|
|
|
|
Please read this short document if you want to contribute to Halfmoon.
|
|
|
|
## Our goal
|
|
|
|
Before getting to the issues and pull requests, it is important to understand what the framework is trying to do.
|
|
|
|
Halfmoon's stated goal is really simple - create a customizable frontend framework, with a built-in dark mode, that is great for building dashboards and tools. However, our other goals are more implicit:
|
|
|
|
- Everything has to be **super functional and snappy**. Ideally, that means no performance issues and just consistently good execution.
|
|
- Everything has to **look good** as well, and have a **single, consistent style**.
|
|
|
|
The most important thing here is building a **really good (looking) framework that also works very well**, and that should always be the top priority.
|
|
|
|
## Issues
|
|
|
|
Please keep the following things in mind when raising issues:
|
|
|
|
- Feature requests are welcome. However, please make sure that the feature you are requesting falls under the scope of the project.
|
|
- **Do not** post personal support questions as issues. For those, use this [tag on Stack Overflow](https://stackoverflow.com/questions/tagged/halfmoon).
|
|
- When raising an issue, please be as thorough as possible. For possible bugs, reproducible code is always a great sign.
|
|
|
|
## Pull requests
|
|
|
|
**Please ask first** before you put in work for a pull request. Things are constantly being worked on, and it is very difficult to share everything publicly in a meaningful way. So asking lets us avoid working on the same thing, or worse, someone putting in a lot of work for a PR that does not fit into the scope of the project. Please do not take this the wrong way; at this stage, the project needs strong leadership to become something special.
|
|
|
|
The best way to ask is through email: [hey.halfmoon@gmail.com](mailto:hey.halfmoon@gmail.com). I am always open to proper discussions about the framework, especially when it comes to contributions and pull requests.
|
|
|
|
## License
|
|
|
|
Any contribution you make will fall under the license being used by the framework: [MIT license](https://www.gethalfmoon.com/license/).
|