miiila / junior.guru

Learn to code and get your first job in tech 🐣

junior.guru

Status of the README

This README is missing a lot of information. Honza didn't have time yet to add a proper, nice README. The file currently only includes documentation of the hard parts of the development process, which would be easy to forget and difficult to learn again.

Setting up email address

According to spectrum.chat/zeit:

1. Run following:

   $ now dns add junior.guru '@' MX mx1.improvmx.com 10
   $ now dns add junior.guru '@' MX mx2.improvmx.com 20
   $ now dns add junior.guru '@' TXT 'v=spf1 include:spf.improvmx.com ~all'
   

2. Fill the form at ImprovMX

3. Setup and verify the address in MailChimp

Setting up Google Drive credentials

1. Follow the steps in the gspread guide. Instead of Google Drive API, enable Google Sheets API.
2. Save the obtained JSON file into the juniorguru/fetch directory as google_service_account.json
3. Make sure it is ignored by Git
4. Run cat juniorguru/fetch/google_service_account.json | pbcopy to copy the JSON into your clipboard (macOS)
5. Go to CircleCI project settings, page Environment Variables
6. Add GOOGLE_SERVICE_ACCOUNT variable and paste the JSON from your clipboard as a value

The service account's email address needs to be manually invited wherever it should have access. If it should be able to access Google Analytics, go there and invite it as if it was a user.

Setting up MailChimp credentials

1. Follow MailChimp's own guide on how to create an API key
2. Set it as MAILCHIMP_API_KEY environment variable for both local devlopment and production

Setting up SMTP credentials

1. If using Gmail for sending e-mails, create an app password.

2. Set the following environment variables:

   export SMTP_HOST='smtp.example.com'
   export SMTP_PORT='587'
   export SMTP_USERNAME='[e-mail]'
   export SMTP_PASSWORD='abc...xyz'

By default, sending is not enabled. On production or when trying to send e-mails from localhost an environment variable SMTP_ENABLED needs to be set to something truthy.

Logging

The environment variable LOG_LEVEL affects what gets filtered out. It's set to info by default.