mischa-s / bigger_boilerplate

YIP Alumni Network Map

netlify env variables

node.env = production api url asset url

table of contents

• start
• design
• stack
• folder structure
• scripts
  • npm start
  • npm run dev
  • TODO npm test
  • npm run lint
  • npm run sql
• notes

start

before you start, please

• install node@8 and npm@5
• install git-lfs
• install and set up Postgres for your system
• create a database in Postgres named network_map (see Postgres DEV setup)
• install Redis

git clone https://github.com/mischa-s/alumni_net_map.git
cd alumni_net_map
npm install
npm run sql migrate:latest
npm run sql seed:run
npm run dev

design

ux

data models

• users
  • id
  • name
  • email

architecture

• web server
• mailer worker

stack

• web server
  • @feathersjs/socketio
  • @feathersjs/authentication
  • @feathersjs/authentication-jwt
  • feathers-stripe
  • node-resque
  • docker-remote-api
• web app
  • next.js
  • ramda
  • @feathersjs/socketio-client
  • @feathersjs/authentication-client
  • react
  • react-hyperscript
  • recompose
  • fela
  • material-ui
  • react-stripe-elements
• mailer worker
  • node-resque
  • nodemailer
  • third-party: sendgrid
  • dev tool: maildev

folder structure

we're following the dogstack folder structure convention, adapted for our stack.

available scripts

npm start

starts production server

npm start

npm run dev

starts development server

npm run dev

TODO npm test

runs ava tests

Can optionally take a glob

npm test -- './todos/**/*.test.js'

Default glob is ./**/*.test.js ignoring node_modules

npm run lint

checks for standard style

can optionally take a glob

npm run lint -- './todos/**/*.js'

default glob is ./**/*.js ignoring node_modules

npm run sql

runs knex command, with any arguments.

npm run sql migrate:latest

npm run sql seed:run

notes

Postgres DEV setup

use a ~/.pgpass file to automate your passwords!

echo "localhost:5432:*:postgres:postgres" > ~/.pgpass
chmod 600 ~/.pgpass

create your database with:

createdb network_map -h localhost -U postgres

drop your database with:

dropdb network_map -h localhost -U postgres

connect to your database with:

psql -h localhost -U postgres -d network_map

background image

https://pixabay.com/en/love-heart-set-seamless-pattern-3102033/

• search terms
  • seamless
  • tile
  • repeating
  • geometric
  • abstract
  • mosaic
• open source friendly websites
  • pixabay.com

emoji

• https://afeld.github.io/emoji-css/

license

AGPL-3.0

attributions

• Emoji artwork is provided by Twemoji and is licensed under CC-BY 4.0