This repository contains the source code for a map of the hometowns of anyone who attends the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub. Participants learn best practice GitHub workflows, add their hometown to locations.txt, and see the giant community they're part of!
- Make a GitHub account.
- Fork this repository.
- Add your hometown to
locations.txt. - Commit your changes and make a pull request.
- Ask someone else to comment on your pull request.
- Wait for the workshop organizer to approve your pull request.
- Refresh the map!
The map itself is a Node.js application. Node.js allows us to write full-stack
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
Dotenv is a zero-dependency module that loads environment variables from a .env file into process.env. Storing configuration in the environment separate from code is based on The Twelve-Factor App methodology.
Node library for geocoding and reverse geocoding.
Embedded JavaScript templates
To use the Google Maps JavaScript API, you will ned an API Key. The API key is used to track API requests associated with your project for usage and billing. To learn more about API keys, see the API Key Best Practices and the FAQs.
Read the tutorial and configure your API Key
The App reads its locations from the locations.txt file located in the root folder. It will consider each line a different location, so the file should look something like this:
New York, USA
Brazil
JapanTo add a new location, simply append a new line to the locations.txt file
There is also a locations.txt.example file that can be used to test the app. Copy its content to locations.txt and restart the app.
To run this application locally, you'll need to:
- Clone this repository:
git clone https://github.com/MLH/mlh-localhost-github.git
cd localhost-github
npm install
- Set up environment variables:
There is a .env.example file that can be used to configure the app. Simply create a copy named .env
PORT= # Port to be used by the app
GOOGLE_API_KEY= # Google Maps API KEYNow inside the root folder run:
npm start
Now you can access locally in your browser the address http://localhost:3000 and see your locations map.