USSD Aplication built with NodeJs + Postgres + Africa's Talking platform

• Authentication
• Send money
• Check savings
• Change PIN
• View statement

https://my-ussd-app.herokuapp.com

1. Open your terminal

2. Run git clone https://github.com/victkarangwa/USSD-Code-App.git OR Download the project

1. Create a .env file reflecting to .env.example file

2. Add the values to all environmental variables in .env file

3. Make sure you have PostgreSQL installed (You can download it here)

Open termin in the directory you clone the repo from:

1. Run npm install to install all dependencies

2. Using postgres, create database for both dev and testing environment. In your .env, database URL should be of this format: DATABASE_DEV_URL=postgres://[user]:[password]@[host]:[port/[db_name] ex: DATABASE_DEV_URL=postgres://postgres:1122@localhost:5432/ussd_db

3. Run npm run db:migrate or yarn db:migrate to automatically create all necessary models

4. Run npm run db:seed or yarn db:seed to populate data in the database

5. Run npm run start:dev to start local development server. You can also simulate production server locally by running npm start

6. Expose a web server running on your local machine to the internet using ngrok, for more about setting up ngrok use: https://dashboard.ngrok.com/get-started/setup

Please read this article if you want to setup your own simulator

• Victor Karangwa - @victorkarangwa4