anzizhao/hearsay-frontend

Hearsay frontend application

Hearsay Live News App (Frontend)

Introduction:

A clean reading experience for your news. Live demo.

Accompanying repos:

• hearsay-collector
• hearsay-common
• congregator-rssreader
• congregator-sitescraper
• congregator-jsonfetcher

Landing	Article View

Built with:

• node.js
• express
• gulp
• convict
• browserify
• envify
• reactify
• react
• stylus
• bootstrap
• fontawesome

Testing:

• jest

Dependencies:

• nodejs
• mongodb
• redis

Install dependencies:

• brew/apt-get install nodejs
• brew/apt-get install redis
• brew/apt-get install mongodb
• npm install -g mocha
• npm install -g gulp
• npm install

Environment variables:

• PORT - Port exposed by this component.
• example: 3000
• DEBUG - Debug output (* for all) (optional)
• example: *
• NODE_ENV - Environment ('development', 'staging', 'production')
• example: development
• CLIENT_API_PATH - Path to the client REST api (relative)
• example: /api
• CLIENT_DOMAIN - Server domain
• example: localhost
• APPSECRET - Application session secret
• example: sOmeCrAzYhAsH894372
• SESSION_KEY - Application session secret (optional)
• example: express.sid (defaults to connect.sid)
• REDIS_URL - Redis url (including authentication)
• example: redis://user:pass@localhost:6379
• REDIS_DB - Redis database number (optional)
• example: 1
• REDIS_SESSION_PREFIX - Prefix for redis session entries (optional)
• example: sess:
• MONGO_URL - MongoDB url (including authentication)
• example: mongodb://user:pass@localhost:27017/mydatabase

Run tests:

• npm test

Run the application:

• set environment variables
• gulp
• (create a shellscript with the above for convenience if you want)
• navigate your browser to http://localhost:3000 (or whatever port you chose for PORT)

Development shellscript example:

#!/bin/sh
export PORT=3000 \
export DEBUG="*" \
export NODE_ENV="development" \
export APPSECRET="somecrazyhash" \
export CLIENT_API_PATH="/api" \
export CLIENT_DOMAIN="localhost" \
export CLIENT_API_DOMAIN="localhost" \
export SESSION_KEY="express.sid" \
export MONGO_URL="mongodb://localhost/hearsay" \
export REDIS_URL="redis://localhost:6379" \

gulp