README.md

Taskmeow

This is a simple todo list app that showcases the capabilities of the Teams Platform. It's deployed to https://taskmeow.com. You can sideload it into your Teams Client using one of the app packages from the manifest folder.

Installing

git clone https://github.com/ydogandjiev/taskmeow.git
cd taskmeow
yarn install

Running The App

The template can be run in development, or in production. For development, use the following workflow.

Configure environment

Create a .env file at the root of the repository with the following values:

APPSETTING_AAD_ApplicationId="<AAD App ID>"
APPSETTING_AAD_ApplicationSecret="<AAD App Secret>"
APPSETTING_AAD_BaseUri="<SSL Base Uri>"
SQLCONNSTR_DbUri="<DB Uri>"
SQLCONNSTR_DbUsername="<DB Username>"
SQLCONNSTR_DbPassword="<DB Password>"
APPINSIGHTS_INSTRUMENTATIONKEY="AppInsights Instrumentation Key"

Start Create React App and Express Server

yarn start

Start ngrok tunnel

For authentication to work it's recommended to use an ngrok tunnel to hoist the localhost site to an SSL uri:

ngrok http 3001 --host-header=rewrite [--subdomain=<YOUR_SUBDOMAIN>]

Building For Production

In production, you want Express to serve up your app.

Build React App

yarn build

Now simply visit the Express app at 'http://localhost:3001' and you will see your app served from the 'build' folder. That's all there is to it!