diff --git a/README.md b/README.md
index e69de29..edfb24e 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,96 @@
+# Easily add [SFML 3](https://github.com/SFML/SFML) and [Dear ImGui](https://github.com/ocornut/imgui) to your premake5 projects
+<br> This repo contains the repositories for SFML, Dear ImGui, sfml-imgui, flac, vorbis, ogg, and freetype along with premake build scripts. 
+This allows your project to build these libraries from source and statically link them to your executible. 
+this makes developing on linux easier as most distros don't have SFML 3 in their package managers.
+<br><br> I have included `example-project.txt` and `example-workspace.txt` as examples on how to use this project
+
+## How to integrate into your projects
+1. Add the repository as a submodule and update its submodules 
+<br> -(optional) replace `<directory-path>` with the path to the directory you want the repo to be cloned to, 
+    leaving this out will place this repo into `./imgui-sfml-premake`
+```
+git submodule add https://gitlab.com/JosephA1997/imgui-sfml-premake.git <directory-path><br>
+git submodule update --init --recursive
+```
+2. Add this to the top of the script that contains the workspace, replace 'path/to' with the directory that you cloned this repo to
+```lua
+local ogg = require("path/to/ogg/build-ogg")
+local imgui = require("path/to/build-imgui")
+local sfml = require("path/to/sfml/build-sfml")
+local flac = require("path/to/flac/build-flac")
+local vorbis = require("path/to/vorbis/build-vorbis")
+local freetype = require("path/to/freetype/build-freetype")
+local imguisfml = require("path/to/imgui-sfml/build-imgui-sfml")
+```
+3. In the workspace, add these lines
+```lua
+filter"system:linux"
+    pic"On" -- fix warning when statically linking <relocation against ... in read-only section .text>
+filter""
+
+externalwarnings "Off" --turn off build warnings created from sfml, imgui, and it's depedencies
+```
+4. In the workspace, add these lines to add each dependency as its own project
+<br> `<target-directory>` - the directory where the static library will be placed
+<br> `<obj-directory>` - the directory where object files will be placed 
+```lua
+ogg.generateproject(<target-directory>, <obj-directory>)
+sfml.generateproject(<target-directory>, <obj-directory>)
+flac.generateproject(<target-directory>, <obj-directory>)
+imgui.generateproject(<target-directory>, <obj-directory>)
+vorbis.generateproject(<target-directory>, <obj-directory>)
+freetype.generateproject(<target-directory>, <obj-directory>)
+imguisfml.generateproject(<target-directory>, <obj-directory>)
+```
+5. At the top of each lua file containing a project that needs imgui or sfml, add these lines, replace 'path/to' with the directory that you cloned this repo to. if the project is in the same file as the workspace you can skip this
+```lua
+local sfml = require("path/to/build-sfml")
+local imgui = require("path/to/build-imgui")
+local imguisfml = require("path/to/build-imgui-sfml")
+```
+6. Inside of the projects that need sfml or imgui add these lines 
+```lua 
+-- link order matters on GCC/Clang
+imgui.link()
+imguisfml.link()
+sfml.link()
+```
+
+## Bundled Premake Info
+I have included premake5 executibles for windows and linux in the `premake5` directory. Inside you'll also find modules that add support for the ninja build system and to generate a compile_commands.json file for things like clangd
+<br><br>
+To use premake on windows
+```
+.\path\to\premake5\premake5.exe
+```
+And on linux
+```
+./path/to/premake5/premake5
+```
+To generate ninja build files, use the `premake-ninja` action
+```
+premake5 premake-ninja
+```
+To generate compile_commands.json, use the `ecc` action
+```
+premake5 ecc
+```
+<br>
+Credits:
+
+* [SFML](https://github.com/SFML/SFML) (zlib/png license)
+   Copyright (C) Laurent Gomila
+
+* [Dear ImGui](https://github.com/ocornut/imgui) (MIT License)
+   Copyright (c) 2014-2025 Omar Cornut
+
+* [imgui-sfml](https://github.com/SFML/imgui-sfml/) (MIT License)
+    <br>Copyright (c) 2016 Elias Daler
+    <br>Copyright (c) 2014-2016 Omar Cornut and ImGui contributors
+    <br>Copyright (c) 2014 Mischa Aster Alff
+
+* [FreeType](https://github.com/freetype/freetype) (The FreeType Project License)
+   Portions of this software are copyright © 2025 The FreeType Project (www.freetype.org). All rights reserved.
+
+* [Ogg](https://github.com/xiph/ogg), [Vorbis](), [FLAC]() (BSD-3-Clause)
+   Copyright (c) Xiph.Org Foundation
\ No newline at end of file