Getting Started

C
Charles Holbrow•

Take a moment to study the structure of the website/app/ directory of the class repo. Notice how website/app/syllabus/ has a page.md file? Whenever this file changes on the main branch a GitHub action builds a new version of the website, and publishes it to ep390.vercel.app/syllabus

Notice how this filename maps to a web "route".

This is a general pattern. We'll use it to create pages for assignments. You will put your assignments in a nested directory, for example:

Hands On

First, ensure Node.js is installed.

Now we will create a page on the class website like Alice's above. Clone the repository and install the development environment by executing these commands in the terminal. You can use GitHub Desktop to clone if you prefer.

git clone https://github.com/ep390/ep390.git
cd ep390/website/
npm install
npm run dev

This will start a "development" web server on your local machine that runs the class website, probably at http://localhost:4000

2. Update Your Page

Creating a new branch is essential for submitting your homework correctly!

When starting work in a shared git repository always begin by creating a new git branch, for example

git checkout -b alice-page

Substitute alice-page with a suitable branch name.

You can use GitHub Desktop if you do not want to use the Terminal.

Create a new directory with your name and add a page.md, for example website/app/students/alice/page.md

Copy Alice's introductory blog post, and replace her content and thoughts with your own. What do you think AI is useful / overhyped for?

---
title: "Alice's EP-390"
date: "2025-08-23"
author:
  name: "Alice"
---

I'm an example student taking EP 390!

I think generative AI is useful for doing your homework for you.

I think generative AI could be over-hyped for its ability to self-improve.

Important: this will be posted on the public internet so keep it professional!

You may use a screen-name instead of your first name, but make sure your professor knows who the page belongs to.

Navigate to the local version of your newly created page, which will look something like Alice's:

http://localhost:4000/students/alice

Ensure it looks good before proceeding.

3. Push and create a PR

Tell the instructor your GitHub username. After they add you to the class Repository push your branch, for example:

git push -u origin alice-page

Now use GitHub to create a pull request from your branch to the main branch.

← Back to Home↑ Back to modules