diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3512f9a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+Welcome! 
+
+In this repository for playwright in TS for TestCoders' RPG game I have created a testing framework. 
+
+To run this on your machine, please clone the following repository by using the following command: 
+git clone https://github.com/RockStar268/Playwright-TS-JS
+
+To install repo dependencies: 
+npm install
+
+To run the tests in this repo, open your terminal in your IDE and run the following command: 
+npm test