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.
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”.
Accept the invitation
- Open the invitation email.
- Click the green View invitation or Join jackjill-health button.
- If asked, sign in to GitHub or create a free account at github.com/join.
- Click Accept invitation on the page that opens.
Confirm you can see the projects repo
- Go to github.com and sign in.
- Click your profile picture (top right) → Your organizations → jackjill-health.
- You should see a repository called projects. Click it.
- You should see folders named
ahmad,pegah,praveen,shahira,abdulla, etc.
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).
Install GitHub Desktop
- Go to desktop.github.com.
- Download and install GitHub Desktop for Windows or Mac.
- Open the app and sign in with the same GitHub account you used in Part 1.
Clone (download) the projects repository
- In GitHub Desktop: File → Clone repository…
- Click the GitHub.com tab.
- Find jackjill-health/projects in the list and select it.
- Choose where to save it (e.g.
Documents\projects) — remember this location. - Click Clone. Wait until it finishes.
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.
Option A — Cursor (recommended)
Install Cursor
- Go to cursor.com and download Cursor.
- Install and open it.
- Sign in when prompted (use your work email or GitHub account).
Open the projects folder in Cursor
- In Cursor: File → Open Folder…
- Select the
projectsfolder you cloned in Part 2 (the one that containsahmad,pegah, etc.). - Click Select Folder.
Sign in to GitHub inside Cursor
- Press
Ctrl + Shift + P(Windows) orCmd + Shift + P(Mac) to open the command palette. - Type GitHub: Sign In and press Enter.
- Follow the browser steps to authorize Cursor to use your GitHub account.
Build with AI in Cursor
- Open the AI chat (usually a panel on the right, or press
Ctrl + L). - Tell it what you want, e.g. “Create a simple HTML dashboard in my pegah folder called patient-summary”.
- Always work inside your own folder (e.g.
pegah/patient-summary/). - Review changes before accepting — make sure files land in the right place.
Option B — Claude Code (terminal app)
Install Claude Code
- Go to Anthropic’s Claude Code docs and follow install steps for your computer.
- Sign in with your Anthropic / Claude account when it asks.
Open your projects folder in the terminal
- Open Terminal (Mac) or PowerShell (Windows).
- Type
cdthen a space, then drag yourprojectsfolder into the window and press Enter.
Example:cd Documents\projects - Type
claudeand press Enter to start Claude Code in that folder.
Connect Claude Code to GitHub
- Inside Claude Code, ask: “Help me authenticate with GitHub” or follow Anthropic’s GitHub integration steps in their docs.
- Make sure Git is installed: download from git-scm.com if needed.
- When you save work, Claude can help you run
git add,git commit, andgit push— or use GitHub Desktop (Part 4) if you prefer clicking buttons.
Option C — Claude.ai in the browser
Use Claude to write HTML, then paste into your folder
- Go to claude.ai and sign in.
- Ask Claude to build your page (e.g. “Build a one-page HTML dashboard for …”).
- Copy the HTML code Claude gives you.
- On your computer, open your
projectsfolder → your name folder → create a new project folder (see Part 4). - Create a file called
index.html, paste the code, and save.
Option D — ChatGPT, v0, Lovable, or other AI builders
Export HTML and add it to the repo
- Build your project in whatever AI tool you prefer.
- Export or download as HTML (or copy the code).
- Place everything in
yourname/project-name/index.htmlinside the clonedprojectsfolder. - 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.
Pick a project name
Use lowercase letters and hyphens only. Good examples:
dashboardpatient-summaryweight-tracker
Bad examples: My Dashboard (spaces), Dashboard! (symbols).
Create your folder structure
Inside the cloned projects folder, create:
yourname/
project-name/
index.html
Example for Pegah: pegah/patient-summary/index.html
ahmad/ or anyone else’s folder unless they asked you to help.Add your HTML file
- Create
index.htmlinside your project folder. - Paste or write your HTML. If you have separate CSS/JS/image files, put them in the same project folder.
- Double-click
index.htmlto open it in your browser and check it looks right before publishing.
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)
Commit your changes
- Open GitHub Desktop.
- Make sure the current repository is projects.
- On the left you will see your new/changed files listed.
- At the bottom left, type a short summary, e.g.
Add patient-summary project. - Click Commit to main.
Push to GitHub
- Click the blue Push origin button at the top.
- Wait until it says “Pushed to origin” or similar.
Find your live link
Wait about 1 minute, then open (replace with your name and project name):
Your personal folder page: https://projects.jackjillhealth.com/yourname/
Share your project link with the team on Slack or email.
Updating your project later
- Edit your files (in Cursor, Claude, or any editor).
- Save.
- In GitHub Desktop: commit again → push again.
- 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.