Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
102 lines (62 sloc) 2.38 KB

Contributing

All contributions are greatly appreciated!

Issues

  • Feature requests/enhancements
  • Bug reports
  • Questions/feedback

Pull Requests

All pull requests are welcome!

  • Fork the repository on GitHub.

  • Clone the forked repo to your local machine.

  • Create a new feature branch from master

  • Commit your changes

  • Push your changes back up to your fork.

  • When you're ready, submit a pull request so that we can review your changes

If you have an existing fork, make sure to pull the latest changes from the upstream repository before working on a new contribution.

$ git remote add upstream https://github.com/lukePeavey/quotable.git
$ git pull upstream master

Running the API Locally

If you are working on changes to the source code, you will want to run the server locally so you test your changes as you work.

Requirements

  • Node >= 12.x
  • NPM >= 6.x
  • MongoDB

1. Create a database

Create a MongoDB database called quotable.

If you don't have MongoDB setup locally, you can use MongoDB Atlas to create a free hosted database.

2. Environment Variables

You need to set the MONGODB_URI environment variable to point to your database.

Create a file called .env in the root directory of the project. Add the following (replace <your-database-uri> with the connection string for your database)

MONGODB_URI=<your-mongodb-uri>

3. Install dependencies

$ npm run install

4. Seed the database

This will populate your database with the sample data included in the repository.

$ npm run database:seed data/sample

4. Start the Server

The server will automatically restart when you make changes to the code.

$ npm run start:dev

5. Running Tests

Before submitting a PR, make sure all tests are passing.

# Runs tests
$ npm run test
# Check for lint issues
$ npm run lint
You can’t perform that action at this time.