Skip to content

Commit e19b55c

Browse files
committed
Add DNS setup instructions and improve workflow
1 parent af0124b commit e19b55c

File tree

2 files changed

+122
-0
lines changed

2 files changed

+122
-0
lines changed

.github/workflows/deploy-pages.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ jobs:
2727

2828
- name: Setup Pages
2929
uses: actions/configure-pages@v4
30+
with:
31+
enablement: true
3032

3133
- name: Upload artifact
3234
uses: actions/upload-pages-artifact@v3

DNS-SETUP.md

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
# DNS Configuration for frontjs.dev
2+
3+
Your website is deployed and ready! Now configure DNS at your domain registrar.
4+
5+
## Quick Setup
6+
7+
At your domain registrar (where you purchased frontjs.dev), add these DNS records:
8+
9+
### For Apex Domain (frontjs.dev)
10+
11+
Add **4 A records** pointing to GitHub Pages IPs:
12+
13+
```
14+
Type: A
15+
Name: @ (or leave blank for root domain)
16+
Value: 185.199.108.153
17+
18+
Type: A
19+
Name: @
20+
Value: 185.199.109.153
21+
22+
Type: A
23+
Name: @
24+
Value: 185.199.110.153
25+
26+
Type: A
27+
Name: @
28+
Value: 185.199.111.153
29+
```
30+
31+
### For WWW Subdomain (www.frontjs.dev)
32+
33+
Add a **CNAME record**:
34+
35+
```
36+
Type: CNAME
37+
Name: www
38+
Value: watthem.github.io
39+
```
40+
41+
## Verification
42+
43+
After DNS propagates (usually 5-60 minutes):
44+
45+
1. Visit https://frontjs.dev - should load your site
46+
2. Visit https://www.frontjs.dev - should redirect to frontjs.dev
47+
3. Check HTTPS is working (🔒 in browser)
48+
49+
## Troubleshooting
50+
51+
### DNS Not Propagating?
52+
53+
Check propagation status:
54+
```bash
55+
nslookup frontjs.dev
56+
dig frontjs.dev
57+
```
58+
59+
Or use online tools:
60+
- https://dnschecker.org
61+
- https://www.whatsmydns.net
62+
63+
### HTTPS Certificate Pending?
64+
65+
GitHub Pages automatically provisions SSL certificates. This can take:
66+
- **5-10 minutes** after DNS is configured
67+
- Up to **24 hours** in rare cases
68+
69+
You can check certificate status:
70+
```bash
71+
gh api repos/watthem/front-js/pages
72+
```
73+
74+
Look for `https_certificate.state` - should be `approved`.
75+
76+
### Site Not Loading?
77+
78+
1. Verify DNS records are correct
79+
2. Check GitHub Pages status: https://www.githubstatus.com
80+
3. Verify CNAME file exists in website directory
81+
4. Check workflow ran successfully: `gh run list`
82+
83+
## Current Status
84+
85+
✅ Repository: Public
86+
✅ GitHub Pages: Enabled
87+
✅ Custom Domain: frontjs.dev configured
88+
✅ CNAME File: Added to website/
89+
✅ Deployment: Automated via GitHub Actions
90+
⏳ DNS: Waiting for configuration at registrar
91+
⏳ HTTPS: Will auto-enable after DNS propagates
92+
93+
## Next Steps
94+
95+
1. Configure DNS records at your registrar (see above)
96+
2. Wait for DNS propagation (5-60 minutes)
97+
3. Verify site loads at https://frontjs.dev
98+
4. Test all pages (main, examples, KB)
99+
100+
## Useful Commands
101+
102+
Check deployment status:
103+
```bash
104+
gh run list --limit 5
105+
```
106+
107+
View latest deployment logs:
108+
```bash
109+
gh run view --log
110+
```
111+
112+
Check Pages configuration:
113+
```bash
114+
gh api repos/watthem/front-js/pages
115+
```
116+
117+
Manually trigger deployment:
118+
```bash
119+
gh workflow run deploy-pages.yml
120+
```

0 commit comments

Comments
 (0)