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