koa-starter

Our Koa starter kit

Description

This project aims at being a "starter kit" for the apps we develop everyday at Mostaza.
We've been parse-server users since its first open source release and we enjoyed it a lot so far, but at the same time we've always looked for more customizable alternative with a smaller footprint, hence we started working on this repo.

Warning: Still a work in progress.

Features

N.B.: A feature should be checked as done only when paired with failing and working tests.

Middlewares:

• [x] Secured routes from unauthenticated access - middlewares/ensureAuthenticated
• [x] Handled parameters validation - koa-bouncer
• [x] Handled cross domain requests - middlewares/allowCrossDomain
• [x] Handled errors - middlewares/errorHandler

Authentication using session tokens (parse-server docet):

• [x] Signup - POST /auth/signup
• [x] Login - POST /auth/login
• [x] Logout - POST /auth/logout
• [x] Email Verification - GET /auth/verify
• [x] Password reset email request - POST /auth/forgot
• [x] Password reset page - GET /auth/reset
• [x] Password reset handling - POST /auth/reset

User routes

• [x] Get authenticated user - GET /user

Entities CRUD:

• [x] Message: get all - GET /messages
• [x] Message: get by id - GET /messages/:id
• [x] Message: create - POST /messages
• [x] Message: patch - PATCH /messages/:id
• [x] Message: delete - DELETE /messages/:id
• [ ] ...other

Utilities:

• [x] Simple logging (not in TEST)

Setup

You must have Postgres installed. I recommend http://postgresapp.com/ for OSX.

git clone [email protected]:themostaza/koa-starter.git
cd koa-starter
touch .env
yarn install
yarn run start-dev

> Server is listening on http://localhost:3000...

Create a .env file in the root directory which will let you set environment variables. yarn run start-dev will read from it.

Example .env:

DATABASE_URL=postgres://username:[email protected]:5432/my-database
[email protected]
MANDRILL_API_KEY=secret-api-key
HTML_VERIFY_EMAIL_SUCCESS_PATH=./public_html/verify_email_success.html
HTML_PASSWORD_UPDATE_REQUEST_PATH=./public_html/password_update_request.html
HTML_PASSWORD_UPDATE_SUCCESS_PATH=./public_html/password_update_success.html

Acknowledgements:

We are grateful to the authors of existing related projects for their ideas and collaboration:

• @danneu