How to get your project online.

This guide walks you through everything — getting access to GitHub, using AI tools like Cursor or Claude, adding your HTML project, and sharing a live link with the team. Take it one step at a time.

What you are building toward

When you are done, your project will have a link anyone on the team can open, for example:

The middle part is your name and the last part is your project folder name. This page lives at abdulla/projects/ — proof the system works.

Part 1 — Get access to GitHub

GitHub is where all team projects are stored. Think of it as a shared folder in the cloud.

1

Wait for your invitation email

Your manager (or Abdulla) will send you an invite to join the jackjill-health organization on GitHub. Check your work email inbox and spam folder.

The email subject will be something like “You've been invited to join jackjill-health”.

2

Accept the invitation

  1. Open the invitation email.
  2. Click the green View invitation or Join jackjill-health button.
  3. If asked, sign in to GitHub or create a free account at github.com/join.
  4. Click Accept invitation on the page that opens.
3

Confirm you can see the projects repo

  1. Go to github.com and sign in.
  2. Click your profile picture (top right) → Your organizationsjackjill-health.
  3. You should see a repository called projects. Click it.
  4. You should see folders named ahmad, pegah, praveen, shahira, abdulla, etc.
Stuck? Ask Abdulla to confirm your invite was sent and that you accepted it. You need access before any tool will work.

Part 2 — Get the projects folder on your computer

You need a copy of the repo on your laptop. The easiest way is GitHub Desktop (no typing commands).

1

Install GitHub Desktop

  1. Go to desktop.github.com.
  2. Download and install GitHub Desktop for Windows or Mac.
  3. Open the app and sign in with the same GitHub account you used in Part 1.
2

Clone (download) the projects repository

  1. In GitHub Desktop: FileClone repository…
  2. Click the GitHub.com tab.
  3. Find jackjill-health/projects in the list and select it.
  4. Choose where to save it (e.g. Documents\projects) — remember this location.
  5. Click Clone. Wait until it finishes.
Done when: You see the projects folder on your computer with folders like ahmad, pegah, and your own name inside.

Part 3 — Connect your AI tool to GitHub

Pick the tool you use. All of them need access to the same projects folder you cloned in Part 2.

Cursor Claude Code Claude.ai (browser) Other AI tools

Option A — Cursor (recommended)

1

Install Cursor

  1. Go to cursor.com and download Cursor.
  2. Install and open it.
  3. Sign in when prompted (use your work email or GitHub account).
2

Open the projects folder in Cursor

  1. In Cursor: FileOpen Folder…
  2. Select the projects folder you cloned in Part 2 (the one that contains ahmad, pegah, etc.).
  3. Click Select Folder.
3

Sign in to GitHub inside Cursor

  1. Press Ctrl + Shift + P (Windows) or Cmd + Shift + P (Mac) to open the command palette.
  2. Type GitHub: Sign In and press Enter.
  3. Follow the browser steps to authorize Cursor to use your GitHub account.
Why? This lets you save (push) your work to the team repo without leaving Cursor.
4

Build with AI in Cursor

  1. Open the AI chat (usually a panel on the right, or press Ctrl + L).
  2. Tell it what you want, e.g. “Create a simple HTML dashboard in my pegah folder called patient-summary”.
  3. Always work inside your own folder (e.g. pegah/patient-summary/).
  4. Review changes before accepting — make sure files land in the right place.

Option B — Claude Code (terminal app)

1

Install Claude Code

  1. Go to Anthropic’s Claude Code docs and follow install steps for your computer.
  2. Sign in with your Anthropic / Claude account when it asks.
2

Open your projects folder in the terminal

  1. Open Terminal (Mac) or PowerShell (Windows).
  2. Type cd then a space, then drag your projects folder into the window and press Enter.
    Example: cd Documents\projects
  3. Type claude and press Enter to start Claude Code in that folder.
3

Connect Claude Code to GitHub

  1. Inside Claude Code, ask: “Help me authenticate with GitHub” or follow Anthropic’s GitHub integration steps in their docs.
  2. Make sure Git is installed: download from git-scm.com if needed.
  3. When you save work, Claude can help you run git add, git commit, and git push — or use GitHub Desktop (Part 4) if you prefer clicking buttons.

Option C — Claude.ai in the browser

1

Use Claude to write HTML, then paste into your folder

  1. Go to claude.ai and sign in.
  2. Ask Claude to build your page (e.g. “Build a one-page HTML dashboard for …”).
  3. Copy the HTML code Claude gives you.
  4. On your computer, open your projects folder → your name folder → create a new project folder (see Part 4).
  5. Create a file called index.html, paste the code, and save.
Note: Claude in the browser cannot push to GitHub by itself. Use GitHub Desktop in Part 4 to publish.

Option D — ChatGPT, v0, Lovable, or other AI builders

1

Export HTML and add it to the repo

  1. Build your project in whatever AI tool you prefer.
  2. Export or download as HTML (or copy the code).
  3. Place everything in yourname/project-name/index.html inside the cloned projects folder.
  4. Publish using Part 4 (GitHub Desktop is easiest).

Part 4 — Create your first project

Every project is a folder with an index.html file inside.

1

Pick a project name

Use lowercase letters and hyphens only. Good examples:

  • dashboard
  • patient-summary
  • weight-tracker

Bad examples: My Dashboard (spaces), Dashboard! (symbols).

2

Create your folder structure

Inside the cloned projects folder, create:

yourname/
  project-name/
    index.html

Example for Pegah: pegah/patient-summary/index.html

Rule: Only add files inside your own folder. Do not edit ahmad/ or anyone else’s folder unless they asked you to help.
3

Add your HTML file

  1. Create index.html inside your project folder.
  2. Paste or write your HTML. If you have separate CSS/JS/image files, put them in the same project folder.
  3. Double-click index.html to open it in your browser and check it looks right before publishing.
4

List your project on your folder page

Open yourname/projects.json and add your project so it shows when you visit https://projects.jackjillhealth.com/yourname/

{
  "displayName": "Pegah",
  "projects": [
    {
      "slug": "patient-summary",
      "title": "Patient summary",
      "description": "Short description of your project"
    }
  ]
}

Ask Cursor or Claude to update this file for you — paste @FOR-AI-TOOLS.md in Cursor first.

Part 5 — Publish (push to GitHub)

When you push, the team site updates automatically within about a minute.

Using GitHub Desktop (easiest)

1

Commit your changes

  1. Open GitHub Desktop.
  2. Make sure the current repository is projects.
  3. On the left you will see your new/changed files listed.
  4. At the bottom left, type a short summary, e.g. Add patient-summary project.
  5. Click Commit to main.
2

Push to GitHub

  1. Click the blue Push origin button at the top.
  2. Wait until it says “Pushed to origin” or similar.
That’s it! The site redeploys on its own when you push — no extra steps needed.
3

Find your live link

Wait about 1 minute, then open (replace with your name and project name):

https://projects.jackjillhealth.com/yourname/project-name/

Your personal folder page: https://projects.jackjillhealth.com/yourname/

Share your project link with the team on Slack or email.

4

Updating your project later

  1. Edit your files (in Cursor, Claude, or any editor).
  2. Save.
  3. In GitHub Desktop: commit again → push again.
  4. Refresh your live link after ~1 minute to see changes.

Need help?

“I don’t see the jackjill-health org” — Your invite may not be accepted. Check email or ask Abdulla to resend.

“Push failed” or “Permission denied” — You may not have write access. Ask Abdulla to confirm you are a member of the projects repo.

“My link shows Page not found” — Check: (1) folder name matches URL exactly, (2) you have index.html inside the project folder, (3) you pushed to main, (4) wait another minute.

“I broke something” — Tell Abdulla before trying to fix Git conflicts yourself.