kevmoo / github_email_notify

Custom emails for your labels and repos you care about

Send emails when GitHub labels change.

Getting started

Deploy a simple sample app first.

Read through and deploy the Dart App Engine sample.

• This is a complex app. If you can't get the sample running, you'll go crazy trying to get all of this up and going.

Configure App Engine

• Enable GMail API.
• Follow the other instructions for enabling an Dart App Engine app.

Configure GitHub

• Enable GitHub Webhooks for a repository. Make sure that Issues events are enabled for the web hook.

Configure Firebase

• Create a new project.
• Make sure your security rules are set correctly.

{
  "rules": {
    "repos": {
      "$repo" : {
        "labels": {
          ".read": true
        },
        "users" : {
          "$user_id": {
            ".write": "$user_id === auth.uid",
            ".read": "$user_id === auth.uid"
          }
        }
      }
    }
  }
}

Update app.yaml

• There are a lot of services you need to configure.
• Copy app.sample.yaml to app.yaml.
  • app.yaml is explicitly ignored in .gitignore to make sure you don't commit a bunch of secrets to a public GitHub repo.
• See lib/src/environment_variable_access.dart for details.

Running locally

There have been changes to the gcloud tool which require custom arguments be passed.

gcloud preview app run --custom-entrypoint "dart bin/server.dart --port={port}" app.yaml

TODO(kevmoo): add more details here

Technologies

• Dart on Google App Engine
• Angular2 - Dart
• GitHub Webhooks
• Firebase
• Google APIs: GMail