Navigation Menu

Skip to content

tmikeschu/the-spoken-tour

Repository files navigation

Build Status

The Spoken Tour

Some friends of mine are going to bike from Denver, Colorado to Buenos Aires, Argentina, so I helped build their travel blog using React (thanks to CRA and RGM).

V2 Styles (December 2017)!

desktop mobile

See a video demo of the app

Links

clicky clicky clicky

Setup

To get your machine and this code friendly and acquainted:

Clone this repository using your preferred method and cd into it. If you're not sure, I recommend the SSH route:

git clone git@github.com:tmikeschu/the-spoken-tour.git
cd the-spoken-tour

Then, install dependencies:

yarn install

Credentials

# copy configuration
cp .env.example .env

You'll need to create your own Google Maps API key, and you'll have to contact me for the Rails API key.

Testing

First things first: get a dopamine hit from a verdant test suite! Run the tests with:

yarn test

Then read the tests to get oriented with the application.

Local Development

What fun is setting up and running tests if you can't do some of your own stuff? Start the local server with:

yarn start

Stack

Node: 8.1.2

Languages: JavaScript/ES6

DBs: External API

Major Libraries:

DevOps: Heroku

CI: Travis CI

Other: Prettier and ESLint

Style

When contributing to code, be the tofu. In other words, take on the style of the existing code. Here are some main approaches I follow:

  • If a component doesn't hold its own state, write it as a pure function
  • ES6
  • No semi-colons
  • Double quotes
  • Unit tests for functions that process data
  • For functions with side effects, unit test with mock jest.fn() functions to verify the call of other functions.
  • Dependency injection for any API service functions

Contributing

Interested in helping out?

  1. Reach out to me and say hello! I'd love to hear about what you're interested in.

  2. Once we've confirmed what you can work on, fork this repo and work on your masterpiece.

  3. Once your work is done, squash your work to a single commit, and open a PR from your feature branch to this repo's master branch.

Releases

No releases published

Packages

No packages published