notes-app

Node.js application for managing notes.

This repo serves as a playground for the following technologies:

• Node.js
• Express framework
• Objection.js ORM
• PostgresSQL
• Socket.io
• EventEmitter
• Unit and Functional Testing
• Running the app with Docker
• Remote debugging with Chrome DevTools or Visual Studio Code using node --inspect option with latest Node.js version

Before installing make sure you have Node version >= 5.0 and NPM >= 3 and that PostgreSQL has "uuid-ossp" module installed as an extension:

• SELECT * FROM pg_available_extensions;
• CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
• createdb notes_development
• createuser postgres

Instead of installing Postgres and Node on your local machine, you can use Docker!

Features

• New account signup using email and password or OAuth provider (Facebook)
• Reset password feature
• Notes CRUD pages
• My profile page with extra option to link/unlink OAuth provider
• Automatic updating of notes list on /notes page when anyone updates, deletes or creates new note
• Contact form
• Simple API examples /api/v1/users, /api/v1/notes

Quick start

# clone our repo
# --depth 1 removes all but one .git commit history
git clone --depth 1 https://github.com/sasha7/notes-app.git

# change directory to our repo
cd notes-app

# install the repo with npm
npm install

# run setup.js to setup initial environment in .env file
npm run setup

# create postgres db
createdb --encoding utf8 notes-development

# start the server

npm start

# or start the server in watch mode using nodemon with support for debugging

npm run watch

go to http://0.0.0.0:3000 or http://localhost:3000 in your browser

Running the app with Docker

Use docker-compose up which will run two containers:

• Node App with latest Node.js version
• Postgres DB server

# start docker containers
docker-compose up

# after docker containers are ready, login to notesapp container and run migrations
$ docker exec -it $(docker ps | grep notesapp_notesapp | awk '{ print $1 }') bash
npm run db:migrate

# stop docker containers
docker-compose stop

REST API Example usage

# You can pretty print json responses by using pipe operator and
# the following commands: `| python -mjson.tool` or `| jq`.
# If needed, install `jq`in OSX: `brew install jq`

# All note ids are using UUIDv4

# GET a list of notes
curl \
--request GET \
http://localhost:3000/api/v1/notes

# Get a single note
curl \
--request GET \
http://localhost:3000/api/v1/notes/:id

# Create a single note
curl \
--header "Content-Type: application/json" \
--request POST \
--data '{"title": "Test Title", "body": "Test note"}' \
http://localhost:3000/notes

# Update a note
curl \
--header "Content-type: application/json"
--request PUT \
--data '{"title:": "Updated title", "body": "Updated note"}' \
http://localhost:3000/notes/:id

# Delete a note
curl \
--header "Content-type: application/json" \
--request DELETE \
http://localhost:3000/notes/:id