Nathans1987: Created page with "
= Godot + Git + Gitea Project Template (Linux) = A reusable workflow for setting up a new Godot project with Git and pushing it to a blank Gitea repository using HTTPS..."

2026-05-17T12:57:40Z

Created page with "<br /> = Godot + Git + Gitea Project Template (Linux) = A reusable workflow for setting up a new Godot project with Git and pushing it to a blank Gitea repository using HTTPS..."

New page

<br />

= Godot + Git + Gitea Project Template (Linux) =
A reusable workflow for setting up a new Godot project with Git and pushing it to a blank Gitea repository using HTTPS.
----

== Prerequisites ==
Before starting:

* Git is installed (<code>git --version</code>)
* A Godot project already exists
* A blank repository has been created in Gitea
* You are inside your Godot project folder in terminal

Example:
<code>git --version
pwd
ls</code>
----

= Initial Project Setup =

== 1. Initialize Git Repository ==
<code>git init</code>
'''What it does:'''

* Creates a hidden <code>.git</code> folder
* Turns the current folder into a Git repository
* Starts tracking version history

Useful when:

* Starting any new project

----

== 2. Create Godot <code>.gitignore</code> ==
<code>cat > .gitignore << 'EOF'
.godot/
.import/
.export/
export_presets.cfg
EOF</code>
'''What it does:'''

* Creates a <code>.gitignore</code> file
* Prevents machine-generated or temporary files being committed

=== Ignored files explained ===

* <code>.godot/</code> → Godot 4 cache/import data
* <code>.import/</code> → legacy import cache
* <code>.export/</code> → export temp files
* <code>export_presets.cfg</code> → local export settings

Why ignore these:

* Reduces repo size
* Avoids merge conflicts
* Keeps commits clean

----

== 3. Stage All Files ==
<code>git add .</code>
'''What it does:'''

* Adds all current files to the staging area
* Prepares them for commit

Think of staging as:

* "These are the files I want included in the next snapshot"

----

== 4. First Commit ==
<code>git commit -m "Initial commit"</code>
'''What it does:'''

* Saves a snapshot of staged files into project history

<code>-m</code> means message.

Good commit messages:

* <code>Add player movement</code>
* <code>Implement inventory system</code>
* <code>Fix wall jump bug</code>

Bad commit messages:

* <code>stuff</code>
* <code>update</code>
* <code>asdf</code>

Future you will thank present you.
----

== 5. Add Remote Repository ==
<code>git remote add origin <nowiki>https://your-gitea-domain.com/username/repository.git</nowiki></code>
Replace URL with your Gitea repo URL.

'''What it does:'''

* Links local project to remote Gitea repo

Definitions:

* <code>origin</code> = nickname for remote server

Check remotes:
<code>git remote -v</code>
----

== 6. Set Main Branch + Push ==
<code>git branch -M main
git push -u origin main</code>

=== <code>git branch -M main</code> ===

* Renames current branch to <code>main</code>

=== <code>git push -u origin main</code> ===

* Uploads commits to remote
* <code>-u</code> sets upstream so future pushes only need <code>git push</code>

After first push:
<code>git push</code>
is enough.
----

= Save HTTPS Credentials (Optional but recommended) =
<code>git config --global credential.helper store</code>
'''What it does:'''

* Saves HTTPS username/password or token locally after first login

Benefits:

* No repeated login prompts

Stored in:

* <code>~/.git-credentials</code>

Security note:

* Stored in plain text
* Fine for personal Linux machine
* Less ideal on shared computers

----

= Daily Workflow / Future Commits =
After making changes:
<code>git add .
git commit -m "Describe changes"
git push</code>
Typical workflow:

# Code
# Test
# Commit
# Push

----

= Branching =
Useful for testing features safely.

== Create new branch ==
<code>git checkout -b feature-double-jump</code>
'''What it does:'''

* Creates branch
* Switches to it immediately

Now you can experiment without touching main.
----

== Switch branches ==
<code>git checkout main</code>
or:
<code>git checkout feature-double-jump</code>
Moves between branches.
----

== View branches ==
<code>git branch</code>
Current branch has <code>*</code>

Example:
<code>* main
feature-double-jump</code>
----

== Merge branch into main ==
Switch to main first:
<code>git checkout main</code>
Merge:
<code>git merge feature-double-jump</code>
This combines work into main.
----

== Delete merged branch ==
<code>git branch -d feature-double-jump</code>
Keeps repo tidy.
----

= Useful Commands =

== Check status ==
<code>git status</code>
Shows:

* modified files
* staged files
* current branch

Most used Git command.
----

== View commit history ==
<code>git log --oneline</code>
Compact history view.

Example:
<code>4f8a1d2 Add dash mechanic
2a8c114 Initial commit</code>
----

== See changed files ==
<code>git diff</code>
Shows unstaged changes.
----

== Undo unstaged changes ==
<code>git restore filename</code>
Danger: discards local edits.
----

== Unstage file ==
<code>git restore --staged filename</code>
Removes from staging without deleting changes.
----

= Recommended Solo Dev Workflow for Godot =
For small solo projects:

* Commit often
* Push daily or after milestones
* Use branches for risky features
* Keep <code>main</code> stable/playable

Example branch naming:

* <code>feature-inventory</code>
* <code>feature-wall-jump</code>
* <code>bugfix-animation</code>
* <code>refactor-state-machine</code>

----

= Quick Reference Cheat Sheet =
<code>git add .
git commit -m "message"
git push

git checkout -b new-branch
git checkout main
git merge branch-name

git status
git branch
git log --oneline</code>
----End of template.

Godot Git Setup - Revision history

Nathans1987: Created page with " = Godot + Git + Gitea Project Template (Linux) = A reusable workflow for setting up a new Godot project with Git and pushing it to a blank Gitea repository using HTTPS..."

Nathans1987: Created page with "
= Godot + Git + Gitea Project Template (Linux) = A reusable workflow for setting up a new Godot project with Git and pushing it to a blank Gitea repository using HTTPS..."