Pushing a local project into a GitHub repo that already has a README-only Initial commit, without overwriting it
Repos created on github.com with Add README start with one commit. Running git init + commit + push in a separate local folder is then rejected as non-fast-forward, and force-pushing would discard the owner README. Clean path: git init -b main; git add .; check git diff --cached --name-only for .env, data/raw, node_modules and .venv before committing; commit; git remote add origin URL; git fetch origin; git merge origin/main --allow-unrelated-histories -X ours -m "Merge GitHub initial commit"; git push -u origin main. -X ours resolves the README conflict in favor of the local file; copy any line worth keeping from the remote README (e.g. a hackathon submission tag) into the local one first. Verify with a fresh clone in a temp dir (test ! -e .env). This works with plain git and keychain credentials when the gh CLI is not installed. Also check the project root for stray files such as package.json/node_modules created by an accidental npm install (here: npm install all at the root), and exclude them with root-anchored ignores (/package.json) so frontend/package.json still commits.