Skip to content

Commit 3ca263d

Browse files
committed
Add detailed GitHub Pages enablement guide
1 parent 8a874b5 commit 3ca263d

File tree

2 files changed

+66
-1
lines changed

2 files changed

+66
-1
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ pnpm-debug.log*
77

88
# Next.js
99
.next/
10-
out/
10+
# out/
1111
build/
1212
dist/
1313

ENABLE_GITHUB_PAGES.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Enable GitHub Pages - Step by Step Guide
2+
3+
## The Issue
4+
You're seeing "There isn't a GitHub Pages site here" because GitHub Pages hasn't been enabled in your repository settings yet.
5+
6+
## Step-by-Step Solution
7+
8+
### Step 1: Go to Repository Settings
9+
1. Go to your repository: `https://github.com/Just-Curieous/Just-Curieous.github.io`
10+
2. Click on the **Settings** tab (not the Code tab)
11+
12+
### Step 2: Find Pages Section
13+
1. In the left sidebar, scroll down and click on **Pages**
14+
2. You should see a section that says "GitHub Pages"
15+
16+
### Step 3: Configure Source
17+
1. Under **Source**, you should see a dropdown
18+
2. Click the dropdown and select **"GitHub Actions"**
19+
3. **DO NOT** select "Deploy from a branch" - this is the old method
20+
21+
### Step 4: Save Settings
22+
1. Click **Save** button
23+
2. You should see a message that GitHub Pages is being set up
24+
25+
### Step 5: Check Actions Tab
26+
1. Go to the **Actions** tab in your repository
27+
2. You should see a "Deploy to GitHub Pages" workflow running
28+
3. Wait for it to complete (usually 2-3 minutes)
29+
30+
### Step 6: Access Your Site
31+
Once the workflow completes successfully, your site will be available at:
32+
`https://just-curieous.github.io/Just-Curieous.github.io/`
33+
34+
## Visual Guide
35+
36+
```
37+
Repository → Settings → Pages → Source: GitHub Actions → Save
38+
```
39+
40+
## Troubleshooting
41+
42+
### If you don't see the Pages option:
43+
- Make sure you're the repository owner or have admin access
44+
- Check that you're in the Settings tab, not Code tab
45+
46+
### If GitHub Actions isn't an option:
47+
- Make sure you have the `.github/workflows/deploy.yml` file in your repository
48+
- Try refreshing the page
49+
50+
### If the workflow fails:
51+
- Check the Actions tab for error messages
52+
- Make sure all files are committed and pushed
53+
54+
## Important Notes
55+
56+
- **Repository name matters**: Your site URL will be `https://just-curieous.github.io/Just-Curieous.github.io/`
57+
- **First deployment takes time**: Wait 5-10 minutes for the first deployment
58+
- **Subsequent updates**: Will be automatic when you push to main branch
59+
60+
## Still Having Issues?
61+
62+
If you still can't find the Pages option or are having trouble:
63+
1. Make sure you're logged into the correct GitHub account
64+
2. Verify you have admin access to the repository
65+
3. Check that the repository is public (GitHub Pages requires public repos for free accounts)

0 commit comments

Comments
 (0)