docs(whp): add how-to articles (domain, site, email, backups) + placeholder screenshots

Placeholders are 1440x900 'Screenshot pending' PNGs that will be overwritten by real captures via 'npm run screenshots' once a demo user is provisioned.
2026-05-17 10:32:23 -07:00
parent e782234f65
commit 231aa583a0
12 changed files with 342 additions and 0 deletions
@@ -0,0 +1,77 @@
+---
+title: Add a domain
+description: Point a domain at your WHP hosting — whether you registered it with us or elsewhere.
+sidebar:
+  order: 1
+---
+
+import { Steps, Aside } from '@astrojs/starlight/components';
+import SignIn from '~/content/partials/signing-in.mdx';
+import Support from '~/content/partials/support-link.mdx';
+
+## Before you start
+
+- A **registered domain.** We sell domains through Namecheap, and you can also register with any other provider you like.
+- **Access to the registrar's DNS settings** if you registered the domain elsewhere.
+- About 5 minutes (plus DNS propagation time, which can be up to 24 hours).
+
+<Aside type="tip">
+  If you registered your domain with us, we can help with DNS, redirects, and email records directly. If you registered elsewhere, we can still help — you'll just need to make the actual changes at your registrar.
+</Aside>
+
+## Sign in to WHP
+
+<SignIn />
+
+## Steps
+
+<Steps>
+
+1. From the sidebar, open **Domains → Add Domain**.
+   ![WHP Add Domain page](~/assets/screenshots/whp/whp-domains-add.png)
+
+2. Enter your domain (for example, `example.com`). Don't include `http://` or `www.` — just the bare domain.
+
+3. Choose the domain type:
+   - **Primary** — your account's main domain. Pick this if it's your first.
+   - **Add-on** — an extra domain alongside your primary.
+
+4. Click **Add**. WHP confirms the domain and shows the nameserver values and an A record you can point at.
+
+</Steps>
+
+## Point your DNS at us
+
+There are two paths depending on where the domain is registered:
+
+**Registered with us:** nothing to do. We set DNS automatically when the domain was created. Skip ahead to verify.
+
+**Registered elsewhere:** at your registrar, do one of the following:
+
+- Set the **nameservers** to `ns1.anhonesthost.com` and `ns2.anhonesthost.com` (recommended — gives us full DNS control, easier to support), **or**
+- Keep your existing nameservers and add an **A record** pointing the domain to the IP address shown on the WHP confirmation screen.
+
+## Verify it worked
+
+DNS changes can take up to 24 hours to propagate worldwide. To check status:
+
+- Run `dig example.com +short` from a terminal — once you see our IP in the result, you're live.
+- Or use a web tool like [whatsmydns.net](https://www.whatsmydns.net/) to see propagation across many regions.
+
+Once DNS resolves, visiting your domain in a browser will reach WHP — though you'll see a default placeholder until you create a site.
+
+## Troubleshooting
+
+**"Pending DNS" for more than 24 hours.** Re-check the nameservers or A record at your registrar — typos and trailing dots cause silent failures. Clear your local DNS cache to rule out client-side caching.
+
+**Domain returns a generic "site not found" page.** DNS works but you haven't created a site yet. [Create one](/whp/how-to/create-a-site/) and point it at this domain.
+
+**Wrong site loads.** Another site on your account is set as the default. In **Sites**, make sure the correct site is bound to this domain.
+
+## Related
+
+- [Create a site](/whp/how-to/create-a-site/)
+
+## Still stuck?
+
+<Support />