# New Project Setup

## Git Repository

If you're creating a [Blender](https://github.com/spatie/blender) or [Spoon](https://github.com/spatie/spoon) application, first clone its main repository and remove the `.git` folder. This will be the base application for your new project.

Create a repository on the Spatie organization on GitHub using the [repo naming rules](https://guidelines.spatie.be/workflow/version-control#repo-naming-conventions).

Example: `spatie/guidelines.spatie.be`

Lastly, update the `.env.example` file with values relevant to the project (database name, app url, our Slack webhook url, etc.)

## Server

1. Provision a new server on Forge. Use a kebab-cased version of the domain name for the droplet (example: `guidelines-spatie-be`)
2. Create a new site with root `/current/public`
3. Ensure the name of the database makes sense
4. Run our ansible scripts on the freshly provisioned server
5. Start one or two queue workers: `default`, and if using Blender `media_queue`
6. Update the relevant `.env` variables. Don't forget to add the necessary service API keys later.
7. Enable backups in BackupPC for the project
8. Update our shared `.ssh/config` file, so we can SSH to servers without specifying a username

## Services

Our Blender sites use a few third party services. Here's a checklist of what needs to be set up.

Unless specified otherwise, use the website's domain name as its identifier (API key name, property name, etc.)

1. Create a new **Sendgrid** API key
2. Create a new **Google Analytics** property
3. Create a new **Google Tag Manager** container
   * Create a constant containing the Universal Analytics ID
   * Set up a tag for Google Analytics pageviews
4. Set up **Bugsnag** for Laravel
5. Set up **Bugsnag** for JavaScript