Push Your Project to GitHub

Create a GitHub repository and push your Luax Pro project so it can be connected to Netlify, Cloudflare, Vercel, or any other host.

Push Your Project to GitHub

Why GitHub First?

Every deployment guide in this documentation starts with GitHub. Netlify, Cloudflare Pages, and Vercel all read from a Git repository. Even if you plan to deploy to a VPS or cPanel, keeping your project on GitHub gives you version history, backup, and a clean rollback path.

Create a Repository on GitHub

1. Go to github.com/new

2. Enter a repository name (e.g., luaxpro-site)

3. Choose Public or Private

4. Do not check "Add a README" — you already have files locally

5. Click Create repository

GitHub shows you a page with commands. Keep that page open.

Push Your Local Project

Open a terminal in your Luax Pro project folder. Run these commands one by one:

git init
git add .
git commit -m "Initial Luax Pro commit"
git branch -M main
git remote add origin https://github.com/YOUR-USERNAME/YOUR-REPO.git
git push -u origin main

Replace YOUR-USERNAME and YOUR-REPO with your actual GitHub username and repository name.

If you are on Windows and git is not recognized, install Git from git-scm.com first.

Verify the Push

Refresh the GitHub repository page in your browser. You should see:

  • build.lua
  • lax.lua
  • yaml.lua
  • src/ folder
  • templates/ folder
  • public/ folder
  • data/ folder

If you see these, your project is on GitHub and ready to connect to a host.

What Not to Push

Do not commit the dist/ folder. That folder is generated by luax build and is different on every build. Add it to .gitignore if it is not already there:

dist/

Do not commit node_modules/ if you ran npx decap-server locally. That folder is large and platform-specific. Add it to .gitignore:

node_modules/

Common Mistake: Authentication Failed

If git push asks for a password and rejects it, GitHub no longer accepts account passwords for Git operations. You need a Personal Access Token:

1. Go to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)

2. Click Generate new token

3. Check the repo scope

4. Copy the token

5. Use the token as your password when Git prompts

Alternatively, install the GitHub CLI (gh) and run gh auth login to authenticate once.

Next Step

Your project is on GitHub. The next guide covers deploying to Netlify with Decap CMS authentication enabled.