# DipMapper.com GitHub + Namecheap deployment guide

This guide is written for a first-time deployment.

## Part 1. Create the GitHub repository

1. Sign in to GitHub.
2. Click the `+` button in the top right.
3. Click `New repository`.
4. Name the repository `dipmapper`.
5. Choose public or private.
6. Do not add a README, license or gitignore.
7. Click `Create repository`.

## Part 2. Upload the GitHub deployment ZIP

1. Download `dipmapper_v20_7_0_github_deploy.zip`.
2. Unzip it on your computer.
3. Open the new GitHub repository.
4. Click `uploading an existing file`.
5. Drag all unzipped files and folders into GitHub.
6. Scroll down.
7. Add commit message `Deploy DipMapper v20.7.0`.
8. Click `Commit changes`.

## Part 3. Enable GitHub Pages

1. Open the repository on GitHub.
2. Click `Settings`.
3. Click `Pages` in the left menu.
4. Under `Build and deployment`, choose `GitHub Actions`.
5. Click the `Actions` tab.
6. Wait for the deploy workflow to show a green checkmark.
7. Open the GitHub Pages URL shown by GitHub.

## Part 4. Connect dipmapper.com in GitHub

1. Go back to `Settings`.
2. Click `Pages`.
3. In `Custom domain`, enter `dipmapper.com`.
4. Click `Save`.
5. Wait until GitHub checks DNS.
6. When available, enable `Enforce HTTPS`.

## Part 5. Namecheap DNS setup

1. Sign in to Namecheap.
2. Open `Domain List`.
3. Click `Manage` next to `dipmapper.com`.
4. Open `Advanced DNS`.
5. Remove conflicting parking, redirect or old web-hosting records.
6. Add these A records for the root domain:

| Type | Host | Value | TTL |
|---|---|---|---|
| A Record | @ | 185.199.108.153 | Automatic |
| A Record | @ | 185.199.109.153 | Automatic |
| A Record | @ | 185.199.110.153 | Automatic |
| A Record | @ | 185.199.111.153 | Automatic |

7. Add this CNAME record for www:

| Type | Host | Value | TTL |
|---|---|---|---|
| CNAME Record | www | YOUR-GITHUB-USERNAME.github.io | Automatic |

8. Replace `YOUR-GITHUB-USERNAME` with your GitHub username.
9. Save all changes.
10. Wait. DNS can take minutes to several hours.
11. Return to GitHub Pages settings and enable HTTPS once GitHub allows it.

## Part 6. Phone test checklist

1. Open `https://dipmapper.com` on iPhone Safari.
2. Open it on Android Chrome.
3. Confirm the location prompt appears only when needed.
4. Search a destination.
5. Confirm mobile order: search, map, filters plus findings.
6. Tap result `Open`.
7. Tap a numbered map dot.
8. Close the travel card.
9. Change a filter.
10. Confirm the search stops visibly after 10 seconds.
11. Confirm privacy notice stays dismissed after your choice.