New Project Setup

Git Repository

If you're creating a Blender or 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.

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