diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fb88808
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+## Welcome to JavaScriptProjects
+
+This repository contains a collection of JavaScript projects that demonstrate various concepts and techniques in web
+development. Each project is designed to be educational and fun, showcasing different aspects of JavaScript programming.
+
+### Projects Included
+
+| Activities                                         | Description                                                                                     |
+|----------------------------------------------------|-------------------------------------------------------------------------------------------------|
+| [Array Cardio Day](Array-Cardio-Day1/main.html)    | A series of exercises and challenges designed to solidify my understanding of js.               |
+| [Clock](Clock/main.html)                           | A blue clock of fullscreen featuring a Jellyfish on the background.                             |
+| [Flex Panel Gallery](Flex-Panel Gallery/main.html) | A 5-stripped panel of animals gallery.                                                          |
+| [Drum-kit](JavaScriptDrum-Kit/main.html)           | Clickable drum that produces drum sounds while a crowd in a concert are watching you. Have fun! |
+| [Playing](Playing/main.html)                       | You can update CSS variables with 3 sliders adjusting spacing, blur or base color.              |
+| [Type Ahead](TypeAhead/main.html)                  | Type in any city in America and get the query numbers!                                          |
+
+and soon to be more!
\ No newline at end of file