# Neo.mjs Contributing Guide
We are very excited that you are interested in contributing to Neo.mjs.<br>
No worries, you don't need to be a guru, ninja or rockstar to support the project.

## What you can do to help:

### 1. Spread the Word

Neo.mjs thrives on community engagement. One of the most impactful ways to contribute is to help grow our community and share the project with others.

1.  **Star the repository:** This helps with visibility on GitHub.
2.  **Tell your friends and colleagues:** Share your experience with Neo.mjs.
3.  **Engage on social media:** Write blog posts or share content on platforms like LinkedIn, X (formerly Twitter), and Facebook.
4.  **Represent Neo.mjs:** Interested in giving a talk or a workshop at a developer conference? We'd love to support you. Just reach out!
5.  **Uphold our values:** Please stick to our <a href=".github/CODE_OF_CONDUCT.md">Code of Conduct</a> in all interactions.

### 2.  Use the issues tracker
1. In case you got an idea for a new feature
2. In case you find a bug
    1. Ideally, you create a new breaking test inside the tests folder.
    This saves a lot of time and ensures the bug will stay fixed once the ticket is resolved.
3. Please like or comment on current tickets.
    This is a great help to figure out which tickets are the most important ones for the Neo.mjs community.

### 3.  Contribute to the Neo.mjs code base
1. Please ***always*** create a new issue inside our <a href="../../issues">Issues Tracker</a> first and wait for approval.
   This ensures that your idea fits the scope of the project and makes it less likely to get a rejected PR.
   We will do our best to reply to new tickets within 7d max. In case we don't, feel free to bump the ticket.
2. In case you want to work on an existing ticket, please add a comment there and get the ticket assigned to you.
   Otherwise multiple contributors could work on the same item in parallel.
   To keep the project moving, if a ticket is assigned and we do not receive any feedback from the assignee (e.g. via a comment) within 7 days, the ticket may get re-assigned to make it available for other contributors.
3. Please make sure that pull requests are always related to an issue inside our <a href="../../issues">Issues Tracker</a>.
4. Please create PRs for the dev branch and not for master.
5. Please do not copy code from other frameworks / libraries. So far, the entire Neo.mjs code base is written from scratch.
    1. It is simply impossible to verify if contributed code is self-written.
    2. Adding new npm packages => dependencies / devDependencies is fine, in case there are no licensing conflicts.
6. Refer to the <a href="./.github/CODEBASE_OVERVIEW.md">codebase overview</a> to understand how our repository is structured.

### 4.  In case you created a nice app or component using Neo.mjs, please let us know about it.
1.  We are always interested to feature client projects in blog posts or on social media.

<br><br>
Copyright (c) 2015 - today, <a href="https://www.linkedin.com/in/tobiasuhlig/">Tobias Uhlig</a>