diff --git a/infra/.gitlab-ci.yml b/.gitlab-ci.yml
similarity index 100%
rename from infra/.gitlab-ci.yml
rename to .gitlab-ci.yml
diff --git a/README.md b/README.md
index e69de29..6298192 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,107 @@
+
+
+# VolleyManager
+
+### A modern tournament management system built with Flask & Tailwind CSS
+
+
Works perfectly on mobile and desktop
+
+
+
+

+

+

+
+
+
+
+
+## Dashboard & Controls
+
+The central hub for managing tournaments.
+
+
+
+### Appearance Modes
+
+Seamless support for both light and dark environments.
+
+
+

+

+
+
+---
+
+## Tournament Management
+
+### Setup & Creation
+
+
+

+
+
+### Bracket Visualization
+
+Dynamic bracket generation handling various tournament sizes.
+
+
+

+

+
+
+### Bracket Variants
+
+**Single Elimination & Live Scoring**
+
+
+

+

+
+
+---
+
+## Scheduling & Results
+
+Automated scheduling views with real-time score updates.
+
+
+
+---
+
+## Role-Based Scoring
+
+Secure scoring interfaces for Referees and Administrators.
+
+
+
+
+
+ |
+
+
+ |
+
+
+
+
+ Referee View
+
+ Restricted Access
+ Referees must enter a tournament code to submit scores.
+ Note: Clear only appears if scores are already submitted.
+
+ |
+
+ Admin View
+
+ Full Access
+ Admins are free to submit, edit, or override scores at any time without codes.
+
+ |
+
+
+
+## Deploy
+
+Clone the repo and run the docker-compose or create your own. Create a .env file with your custom values there is an example.env available.
diff --git a/docs/bracket-dark.png b/docs/bracket-dark.png
new file mode 100644
index 0000000..cce7093
Binary files /dev/null and b/docs/bracket-dark.png differ
diff --git a/docs/bracket-light.png b/docs/bracket-light.png
new file mode 100644
index 0000000..a4e730b
Binary files /dev/null and b/docs/bracket-light.png differ
diff --git a/docs/bracket-scoring.png b/docs/bracket-scoring.png
new file mode 100644
index 0000000..32c33c4
Binary files /dev/null and b/docs/bracket-scoring.png differ
diff --git a/docs/bracket-single.png b/docs/bracket-single.png
new file mode 100644
index 0000000..cf0505d
Binary files /dev/null and b/docs/bracket-single.png differ
diff --git a/docs/dashboard-admin.png b/docs/dashboard-admin.png
new file mode 100644
index 0000000..8626464
Binary files /dev/null and b/docs/dashboard-admin.png differ
diff --git a/docs/dashboard-dark.png b/docs/dashboard-dark.png
new file mode 100644
index 0000000..1f74be4
Binary files /dev/null and b/docs/dashboard-dark.png differ
diff --git a/docs/dashboard-light.png b/docs/dashboard-light.png
new file mode 100644
index 0000000..519ba17
Binary files /dev/null and b/docs/dashboard-light.png differ
diff --git a/docs/schedule-scoring.png b/docs/schedule-scoring.png
new file mode 100644
index 0000000..517c1f4
Binary files /dev/null and b/docs/schedule-scoring.png differ
diff --git a/docs/schedule.png b/docs/schedule.png
new file mode 100644
index 0000000..82db36a
Binary files /dev/null and b/docs/schedule.png differ
diff --git a/docs/score-admin.png b/docs/score-admin.png
new file mode 100644
index 0000000..31307b9
Binary files /dev/null and b/docs/score-admin.png differ
diff --git a/docs/score-ref.png b/docs/score-ref.png
new file mode 100644
index 0000000..f8f08fa
Binary files /dev/null and b/docs/score-ref.png differ
diff --git a/docs/settings.png b/docs/settings.png
new file mode 100644
index 0000000..151c031
Binary files /dev/null and b/docs/settings.png differ