🚀 Where Am I?

Show your current location on a map 🌍.

Featuring a very serious koala marker 🐨.

👉 Try it live

🛰️ How It Works

The app uses the Geolocation API provided by modern browsers to determine your current location. It leverages the getCurrentPosition() function, which you can learn more about in the MDN documentation. This function retrieves the geographic location of your device, allowing the app to display your position on a map! 🌍📍

🚀 Deployment Options

🌍 Live Demo (Static)

👉 Try it here

(Fast, client-side only — works directly in your browser, no server needed!)

🌐 Deploy to Render (full Node.js version)

🌐 Open in CodeSandbox

🐳 Run with Docker

To run the app in a Docker container on your machine:

1. Install Docker

   [https://docs.docker.com/desktop/] runs on Linux, Mac, and Windows.

2. Clone the Repository

   Clone the repo to your local machine:

   git clone https://github.com/groda/locate-me-now.git

3. Change Directory

   Navigate into the project directory:

   cd locate-me-now

4. Build the image and launch the container

   • For development only:

     docker compose up --build
     

   • In production:

     docker compose -f compose.prod.yaml up --build -d
     

5. **Open http://localhost:3000/ in your browser

   The port $3000$ is hard-coded in Dockerfile, compose.yml, compose.prod.yml, and in server.js.

6. Stop/restart

   Stop the container with:

   docker compose down
   

   Start (without re-building image):

   docker compose up -d
   

💻 Run on Your Local Machine

This guide is for Mac OS. Follow these steps to run the app locally on your machine:

1. Download Node.js®

   Get Node.js from here. (For Mac, I recommend v20.17.0 (LTS) / macOS / using nvm for version management.)

   Open your terminal and run the following commands:

   # Install nvm (Node Version Manager)
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
   
   # Download and install Node.js (may require restarting the terminal)
   nvm install 20
   
   # Verify the correct version of Node.js
   node -v # should output `v20.17.0`
   
   # Verify the correct version of npm
   npm -v # should output `10.8.2`

2. (Optional) Use Specific Node Version

   Not sure if this is required, but if needed:

   nvm use 20.17.0

3. Install Express

   To install the required dependencies:

   npm install express

4. Clone the Repository

   Clone the repo to your local machine:

   git clone https://github.com/groda/locate-me-now.git

5. Change Directory

   Navigate into the project directory:

   cd locate-me-now

6. Start the App

   Run the app with the following command:

   node server.js

7. Access the App

   Once the app starts, you should see a message like: Your app is listening on port 3000. Open http://127.0.0.1:3000 in your browser to view the app in action! 🌐

Why keep the Node.js server?
The app currently runs fully in the browser (no backend needed), but the Express server, Docker setup, and Render deployment are included as a foundation for future features (e.g., saving locations, user accounts, real-time updates, or API integrations). This way, the project is ready to grow without major refactoring later.

📜 Historical Hosting (Archived)

🌐 Former Glitch Demo

The app was previously hosted on Glitch:
Locate Me Now on Glitch (no longer active)

Note: Glitch shut down its free app hosting in 2025. This link is kept for historical reference.

💭 A Bit of jQuery Nostalgia

Feeling nostalgic about the old web days?
Check out NOSTALGIA.md for a short reflection on why removing jQuery felt a little bittersweet.

Badges

✅ CI & Quality Badges

📦 Repo Info

🌟 Social