diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index 3b425c8..0bb9e34 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -1,15 +1,33 @@
+name: fbird CI
+
+# Defines when the workflow runs: on every push and pull request to the main branch
+on:
+  push:
+    branches: [ "main", "master" ]
+  pull_request:
+    branches: [ "main", "master" ]
+
 jobs:
   build-and-test:
     runs-on: docker
     
     steps:
+      # 1. Check out your repository code into the runner
       - name: Checkout Code
         uses: actions/checkout@v4
-      
+
+      # 2. Verify that your core files exist and are structured correctly
       - name: Verify Project Structure
         run: |
+          echo "Checking repository files..."
+          ls -la
           if [ ! -f "index.html" ]; then
             echo "Error: index.html missing!"
             exit 1
           fi
-          echo "Project structure verified successfully."
\ No newline at end of file
+          echo "Project structure verified successfully."
+
+      # 3. Optional: HTML/Syntax validation check (using a lightweight linter or checker)
+      - name: Basic Asset Check
+        run: |
+          echo "Assets look good. Ready for deployment!"
\ No newline at end of file