How to join the fun and get started with contributing to the umbraco community starter project/kit
Tags: umbraco, hacktoberfest, help
Published: 2020-10-09 08:19:35

[Hacktoberfest](https://hacktoberfest.digitalocean.com/) is in town! By submitting 4 prs to open source projects tagged with #hacktoberfest you can earn the necessary credits to complete the challenge! As a bonus Umbraco is also taking part ... read all about it on the blog [https://umbraco.com/blog/hacktoberfest-2020/](https://umbraco.com/blog/hacktoberfest-2020/), if you have 1 approved PR on any of the repo's that are marked by HQ you earn the credits for some swag (or plant a tree :) )

#Umbraco Community starter project/kit
Before october launched the idea of a community powered Umbraco v8 starter kit/project. We had/have discussions on the new [Discussions feature](https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/discussions) of github and decided that we'll be building a site for a non profit org... So this project will be able to get used as inspiration or you can also deploy it for non profit orgs that are looking for an online presense...idea is that with a color palette picker we'll be able to change the look and feel to match the branding of the org.

##Get started
Sounds good right? So how can you get going?

Fork, clone, and start contributing... you don't need VS if you are only interesed in design/frontend/docs

Here is an intro to the PR process on Github

{% youtube nT8KGYVurIU %}

###Keeping your fork up to date
Also make sure to keep your fork up to date (so if other peoples pr get's merged, you also need that in your fork)

{% youtube deEYHVpE1c8 %}

##Design
An design start has been made: a mobile view of the homepage. 

![Umbraco Community preview homepage mobile render](https://dev-to-uploads.s3.amazonaws.com/i/7g2wmtxfbz63x6kzhuvy.png)

You can find preview render and the [figma](https://www.figma.com/) source file here:
[https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/tree/main/design]()

There is a UI Kit with components :) 
[https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/tree/main/design/UI%20Kit](https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/tree/main/design/UI%20Kit)

Design tasks are marked with "design" on the tracker: [https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/issues](https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/issues)

##Frontend
Frontend is currently setup with gulp and tailwind. But you should be able to contribute without visual studio. So also on Mac. 

You can find the markup in the [markup](https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/tree/main/markup) folder.

Tasks will also be added to the issue tracker and marked with "design".

##Backend
For this you'll need windows and visual studio. The solution can be found in the [source](https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/tree/main/source) folder and contains 3 projets (core, web, tests)

You just run the web project from vs and then from the backend (username/pw in readme) you first run a uSyn import to get everyting in sync! 

Tasks are marked with backend (and go from easy to more challenging). Key is here to keep to the best practises... 

##Docs
And last but not least you can also write docs, those will be in the [docs](https://github.com/TimGeyssens/Umbraco-v8-Community-Website-StarterKit/tree/main/source) folder.

Now let's plant some trees!