lostandfoundry - Complete End to End solution

A complete Web Application implementing the lostandfound concept, built using the GrEBoN/NEBoN stack:-

• Gr/N - GraphDB/Neo4j
• E - ExpressJS
• Bo - Bootstrap
• N - NodeJS

Table of Contents

• Requirements
• Configuration
• Run
• Debug

IBM Cloud Enablement

Requirements

Local Development Tools Setup (optional)

• Install the latest NodeJS 6+ LTS version.

IBM Cloud development tools setup (optional)

1. Install IBM Cloud Developer Tools on your machine
2. Install the plugin with: bx plugin install dev -r bluemix

IBM Cloud DevOps setup (optional)

IBM Cloud DevOps services provides toolchains as a set of tool integrations that support development, deployment, and operations tasks inside IBM Cloud. The "Create Toolchain" button creates a DevOps toolchain and acts as a single-click deploy to IBM Cloud including provisioning all required services.

*Note you must publish your project to Github for this to work.

Configuration

The project contains IBM Cloud specific files that are used to deploy the application as part of an IBM Cloud DevOps flow. The .bluemix directory contains files used to define the IBM Cloud toolchain and pipeline for your application. The manifest.yml file specifies the name of your application in IBM Cloud, the timeout value during deployment, and which services to bind to.

Service credentials are taken from the VCAP_SERVICES environment variable if running IBM Cloud Cloud Foundry, from individual environment variables per service if running on IBM Cloud Container Service (see ./server/config/mappings.json), or from a config file if running locally, named./server/config/localdev-config.js.

Run

Using IBM Cloud development CLI

The IBM Cloud development plugin makes it easy to compile and run your application if you do not have all of the tools installed on your computer yet. Your application will be compiled with Docker containers. To compile and run your app, run:

bx dev build
bx dev run

Using your local development environment

The website can be run on a local server by following the steps given below:-

First, clone the repository in your desired directory, and navigate to it.

git clone https://github.com/nimishbongale/lostandfoundry.git
cd yourdirectory

Make sure you have NodeJS installed on your system. Install the node modules by running:-

npm install

If you get an EAuth failure, open the command line/terminal as an adminitrator, or use sudo:-

sudo npm install

Now run the app using:-

npm start

OR, alternatively

node app

Open localhost:3000 on your preferred browser to view the app running.

Session Store

You may see this warning when running bx dev run:

Warning: connect.session() MemoryStore is not
designed for a production environment, as it will leak
memory, and will not scale past a single process.

When deploying to production, it is best practice to configure sessions to be stored in an external persistence service.

Debug

Using IBM Cloud development CLI

To build and debug your app, run:

bx dev build --debug
bx dev debug