[rbdr/dasein] / README.md

# 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][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 JS Doc to generate documentation. Generate everything
with `npm run doc`.

## 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][hapi-style-guide] for
javascript style, and includes eslint configuration to check them. Run
`npm run lint` to check the code.

[docker]: https://www.docker.com/
[hapi-style-guide]: https://hapijs.com/styleguide
Commit	Line	Data
7eb26514 RBR	1	# dasein
7eb26514 RBR	2	A social network
cc69fef4	3
287fa13b RBR	4	## Configuring
	5
	6	This project usese environment variables to work. For most cases, the
	7	defaults work but some sensitive info like keys must be overridden. Copy
	8	the file in `config/env.dist` to `.env` in the project root and override
	9	the values.
	10
	11	When running with `make run`, it'll pick up these values automatically.
	12	If you're doing it the hard way, you'll have to source them.
	13
cc69fef4 RBR	14	## Running Locally
	15
	16	You'll need [Docker][docker] to run the project.
	17
	18	* Run the image with `make run`
	19
	20	## Running locally the hard way
	21
	22	If you don't want to use docker, you can also run it the old fashioned
	23	way.
	24
	25	1. Install dependencies with `yarn install` (recommended), or `npm install`
	26	2. Run with `npm start`
	27
	28	## Generating documentation
	29
	30	This project uses JS Doc to generate documentation. Generate everything
	31	with `npm run doc`.
	32
	33	## Building and pushing the image
	34
	35	You can also do some other operations
	36
	37	* Build the image with `make build`
	38	* Push and build the image with `make upload`
	39	* Clean the environment with `make clean`
	40
287fa13b RBR	41	## Setting up Twitter for login
	42
	43	1. Create an app on https://apps.twitter.com/
	44	2. Make sure you check "Allow this application to be used to Sign in with Twitter"
	45	3. Make sure you specify a callback URL (eg. http://localhost:1927/login-callback)
	46
cc69fef4 RBR	47	## Checking the code
	48
	49	This project uses the [Hapi Style Guide][hapi-style-guide] for
	50	javascript style, and includes eslint configuration to check them. Run
	51	`npm run lint` to check the code.
	52
	53	[docker]: https://www.docker.com/
	54	[hapi-style-guide]: https://hapijs.com/styleguide