Remind James

Azure Functions + Azure Table Storage + Azure Blob Storage + Azure CDN + Twilio API + Vue SPA to send hourly, crowd-sourced, text-based reminders, updated simultaneously by everyone in the world, to one person in particular in need of reminding.

Formerly available at https://www.remindjames.com

Resources

View the resources.md for some of the tutorials, quickstarts, documentation, and troubleshooting used in working on this project.

SaaS Providers

• Azure
• Twilio

Tools

• Azure Storage Explorer
• Postman
• Visual Studio Code .vscode/extensions.json will reccomend two extensions:
  • ms-azuretools.vscode-azurefunctions
  • ms-vscode.csharp
• Vue Dev Tools

Project Setup

1. Add a local.settings.json file (contains keys so removed by .gitignore)

   {
       "IsEncrypted": false,
       "Values": {
           "AzureWebJobsStorage": "", // Azure > Function Apps > Application Settings
           "AzureSignalRConnectionString": "", // Azure > Signal R > Keys
           "TwilioAccountSid": "",    //https://www.twilio.com/console
           "TwilioAuthToken": "",     //https://www.twilio.com/console
           "TwilioPhoneNumber": "",   //https://www.twilio.com/console/phone-numbers/incoming
           "FUNCTIONS_WORKER_RUNTIME": "dotnet"
       },
       "Host": {
           "CORS": "*"
       }
   }

SDK Dependencies

Download and install the SDK for .NET Core 2.1.0+

CLI Dependencies

macOS - Use Homebrew

brew tap azure/functions
brew install azure-functions-core-tools

Windows - Use npm

npm install -g azure-functions-core-tools@core

Package Dependencies

• Extensions.Storage
• Extensions.Twilio
• Extensions.SignalRService

Install via

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage
dotnet add package Microsoft.Azure.WebJobs.Extensions.Twilio
dotnet add package Microsoft.Azure.WebJobs.Extensions.SignalRService -v 1.0.0-preview1-10025

Run Locally

Running Functions

dotnet restore
dotnet build
func start

Running Website

cd wwwroot
#python -m SimpleHTTPServer 8002
live-server --host=localhost --port=8002

Publishing

Azure Functions

1. Deploy to Azure using Azure Functions

   

2. Copy any params from local.settings.json to Functions > Settings

   

Website

1. Add files to blob storage container
   • https://remindjames.blob.core.windows.net/
2. Cache bust the CDN
   • https://remindjames.azureedge.net/
3. Should be visible on Custom Domain
   • https://www.remindjames.com/index.html