BranchesTags

Latest commit

History

121 Commits

Folders and files

NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json

Repository files navigation

MLH Localhost Hometown Map

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!

How to participate in this workshop

  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!

Technologies used in this project

NodeJS

The map itself is a Node.js application. Node.js allows us to write full-stack

NPM packages used

express

Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.

dotenv

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-geocoder

Node library for geocoding and reverse geocoding.

ejs

Embedded JavaScript templates

Try the application locally, if you want!

Google Maps API Key

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

Adding a new location

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
Japan

To 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.

Running the application:

To run this application locally, you'll need to:

  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY

Now 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.

About

This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Latest commit
History
121 Commits
Folders and files
NameName
Last commit message
Last commit date
src
src
static
static
views
views
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
index.js
index.js
locations.txt
locations.txt
package.json
package.json
Repository files navigation
MLH Localhost Hometown Map
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!
How to participate in this workshop
  1. Make a GitHub account.
  2. Fork this repository.
  3. Add your hometown to locations.txt.
  4. Commit your changes and make a pull request.
  5. Ask someone else to comment on your pull request.
  6. Wait for the workshop organizer to approve your pull request.
  7. Refresh the map!
Technologies used in this project
NodeJS
The map itself is a Node.js application. Node.js allows us to write full-stack
NPM packages used
express
Fast, unopinionated, minimalist web framework for node. This is the framework with which we built the application.
dotenv
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-geocoder
Node library for geocoding and reverse geocoding.
ejs
Embedded JavaScript templates
Try the application locally, if you want!
Google Maps API Key
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
Adding a new location
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
Japan
To 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.
Running the application:
To run this application locally, you'll need to:
  • Clone this repository:
git clone https://github.com/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
API_KEY= # Google Maps API KEY
Now 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.
About
This repo contains the source code for the MLH Localhost workshop, How to Collaborate on Code Projects with GitHub.
Resources
Readme
MIT license
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages