~rbdr/dasein

An ephemeral social network
a3f9e260 — Ben Beltran 5 years ago
Merge branch 'release/1.0.0'
f74591da — Ben Beltran 5 years ago
📝 Update README
75d4842c — Ben Beltran 5 years ago
🔧 Update version in package.json

clone

read-only
https://git.sr.ht/~rbdr/dasein
read/write
git@git.sr.ht:~rbdr/dasein

You can also use your local clone with git send-email.

#dasein

A social network

#Configuring

This project usese environment variables to work. For most cases, the defaults work but some sensitive info like keys must be overridden. Copy the file in config/env.dist to .env in the project root and override the values.

When running with make run, it'll pick up these values automatically. If you're doing it the hard way, you'll have to source them.

#Running Locally

You'll need Docker to run the project.

  • Run the image with make run

#Running locally the hard way

If you don't want to use docker, you can also run it the old fashioned way.

  1. Install dependencies with yarn install (recommended), or npm install
  2. Run with npm start

#Generating documentation

This project uses JSDoc to generate documentation. Generate everything with npm run document. The documentation will be generated in the doc directory.

#Building and pushing the image

You can also do some other operations

  • Build the image with make build
  • Push and build the image with make upload
  • Clean the environment with make clean

#Setting up Twitter for login

  1. Create an app on https://apps.twitter.com/
  2. Make sure you check "Allow this application to be used to Sign in with Twitter"
  3. Make sure you specify a callback URL (eg. http://localhost:1927/login-callback)

#Checking the code

This project uses the Hapi Style Guide for javascript style, and includes eslint configuration to check them. Run npm run lint to check the code.