search

ajnart / homarr

Customizable browser's home page to interact with your homeserver's Docker containers (e.g. Sonarr/Radarr)
https://homarr.dev
MIT License
6k stars 275 forks source link

More detailed contribution guidance #2144

Open hucknz opened 2 hours ago

hucknz commented 2 hours ago

Description

Hi, I'd like to contribute a widget but I'm struggling with the contribution process, particularly around local builds for testing.

I have read through the Developer Guides documentation and there's great information around the IDE, etc. but I can't see anything about how to build locally.

I've also looked through the github issues and can see that building locally seems to be discouraged and there's not much in the way of guidance on how to do that.

I've also tried unpicking the github actions to do my own build but am encountering a lot of errors during that process and when the build does succeed my widget isn't included in the build.

I'm not a frontend developer so this is a little outside my normal world and I'm really struggling to get a local build going so I can test my widget out before I contribute a PR. Is there any guidance you can provide, or additions to the developer documentation, that can help me get started?

Priority

Medium (Would be very useful)

github-actions[bot] commented 2 hours ago

Hi 👋. Thank you for submitting your first issue to Homarr. Please ensure that you've provided all nessesary information. You can use the three dots > Edit button to update your post with additional images and information. Depending on the current volume of requests, the team should get in conact with you shortly.