-
To get started, you'll first need to create a GitHub account, which can be done here.
-
Next, you'll need to make a copy of this repository on your own account. To do so, click on
Use this template
(see top right corner of the image below).
- Fill out the information with a repository name of your choice (this example will use
webdev-intro-workshop
). Make sure to make the repository public.
- After your repository is generated, go to the
Settings
tab (right side of the picture below).
- Scroll down to the
GitHub Pages
section, changeSource
tomain
(you can leave the/ (root)
as is) and hitSave
.
- This template is now ready to be hosted on GitHub pages, and you should see a link in the
GitHub Pages
section of settings. It may not work immediately, but after a few minutes you should see the results of the template at the specified URL.
-
Now that we've got GitHub pages working, you'll need to set up a CodeSandbox account. Navigate to the sign-in page and hit
Sign in with GitHub
. After signing in with your GitHub, you'll be redirected to your account dashboard. -
From the dashboard, click on
New Sandbox
. Switch to theImport Project
tab and enter the GitHub URL (for example, https://github.com/arpanlaha/webdev-intro-workshop) of the repository you just created. HitImport and Fork
to generate your sandbox.
-
You'll now have copies of all the files from the template in CodeSandbox. As you make any edits, you'll be able to see the changes reflected on the right-hand panel.
-
Click on the GitHub logo on the left-hand vertical navigation bar (third from the bottom in the screenshot below) and hit
Sign in
.
- After signing in, hit
Link Sandbox
in the same menu pane to link the sandbox you're working on to the repository you just created.
-
You can now make changes in your sandbox and push them to your repository, from which they'll be deployed to GitHub pages. Let's test this out.
-
Switch back to the filesystem view (second icon below my profile picture in the screenshot below) and go to
index.html
.
- On line 11, after
Hello world!
, add some more text (Test
in the example) and save using your operating system's shortcut (Ctrl-s or Cmd-s). You should see this reflected on the right.
- Navigate back to the GitHub menu pane (where we linked our sandbox). Add a short description of your changes to the
Summary
input (not theOptional description
), and hitCommit Changes
. If you then navigate to your GitHub repository, you'll see your changes have been pushed. After a few minutes, you'll also see your changes reflected in the deployed GitHub Pages URl we made in step 6.
- You're now ready to start building your own personal website!
You'll notice that the deployed website will be hosted at <username>.github.io/<repository name>
, or arpanlaha.github.io/webdev-intro-workshop
in our example. If you want to host a website at your GitHub Pages root, or just <username>.github.io
, create a repository with the name <username>.github.io
and follow steps 4-6 from above to enable GitHub Pages.