<aside> ☝ This guide is a simple walkthrough for the first time you set up the project repository, from branch protection settings, issue templates, to setting up continuous integration.

</aside>

Creating the Repository using a Template

You can use our MERN template to initialize a repository using the MERN stack complete with documentation, deployment configuration with Vercel, and CI workflows for linting, formatting, and testing!

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/abf2267d-263d-4822-baa9-20b9332c3999/Screen_Shot_2021-01-26_at_11.17.33_PM.png

Creating the Repository from Scratch

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/a5ba8f9c-6ffc-4ca4-8e9d-f83baa8780f6/Untitled.png

Repository Settings

Go to the 'Settings' tab of your newly created repository.

Features

The goal here is to streamline the features available in your repository, so information is better consolidated and more easily found. You can disable everything except for restricting editing, issues, and preservation.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/9d111070-bdb1-491e-b2ad-1672f26bac01/Untitled.png

Merge Button

Again here we are streamlining what is available to the repository – code should only be merged into the main branch via squash merge, which condenses the commit messages.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c6d54813-c5dc-4cab-82df-1db8b52b280f/Untitled.png

"Automatically delete head branches" should be enabled to automatically delete the branches after merge. This prevents floating dead branches, as described with the image on the right. That way, all branches are active.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6f1fb78a-a588-40a8-a552-a44d5e192d15/Xnip2020-12-06_15-45-36.png