Create your GitHub repository

Set up a public GitHub repository for your project's code and link it back to Stardance.

4 min read

A GitHub repository is the home for your project's code. Stardance uses it to help reviewers and voters see what you built, how it changed over time, and whether the source is public enough for someone else to run.

Create the repository

Go to GitHub and choose New repository.
Name it after your project, or use a short name that is easy to recognize.
Keep the repository public so reviewers can clone and inspect it.
Add a README if you do not already have one locally.

Private repositories, zip files, and Drive folders slow review down. A public GitHub repo is the cleanest path.

Push your code

If your project already exists on your computer, initialize git and connect it to the GitHub repository:

git init
git add .
git commit -m "initial commit"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
git push -u origin main

If you created the repository with a README on GitHub first, clone it instead, then move your project files into that folder:

git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git

Link it to Stardance

Open your project on Stardance, choose Edit project, and paste the root repository URL into the GitHub URL field.

Use this shape:

https://github.com/YOUR_USERNAME/YOUR_REPO

Do not use URLs that end in .git, point to /tree/main, or point to one specific file.

Before you ship

Make sure the repo is public.
Commit meaningful chunks of work as you build.
Keep secrets, API keys, and .env files out of git.
Add a README that explains what the project is and how to run it.

Once the repo is linked, Stardance can point reviewers and voters to the source without you having to explain it every time.

← All guides