diff --git a/absolute-beginners/frontend-beginner/index.mdx b/absolute-beginners/frontend-beginner/index.mdx
index 1c5c4c0..bbcc8d8 100644
--- a/absolute-beginners/frontend-beginner/index.mdx
+++ b/absolute-beginners/frontend-beginner/index.mdx
@@ -1,6 +1,7 @@
---
title: Frontend Development Roadmap 2026
sidebar_label: Frontend Beginner
+position: 1
description: "A step-by-step guide to becoming a frontend developer in 2026."
---
@@ -10,16 +11,10 @@ Welcome to **CodeHarborHub**! This guide is designed to take you from "Hello Wor
Here is the bird's-eye view of your journey. Don't worry about the jargon yet; we’ll break it down piece by piece.
-```mermaid
-graph TD
- A[HTML] --> B[CSS]
- B --> C[JavaScript]
- C --> D[Git & GitHub]
- D --> E[npm & Tooling]
- E --> F[React]
- F --> G[Tailwind CSS]
- G --> H[Vitest]
+```mdx-code-block
+import DocCardList from '@theme/DocCardList';
+
```
## 1. The Core Fundamentals (The "Big Three")
diff --git a/absolute-beginners/frontend-beginner/javascript/_category_.json b/absolute-beginners/frontend-beginner/javascript/_category_.json
new file mode 100644
index 0000000..954a95d
--- /dev/null
+++ b/absolute-beginners/frontend-beginner/javascript/_category_.json
@@ -0,0 +1,8 @@
+{
+ "label": "JavaScript",
+ "position": 3,
+ "link": {
+ "type": "generated-index",
+ "description": "Getting started with JavaScript. This is the start of the most exciting part of the frontend journey. If HTML is the structure and CSS is the skin, JavaScript is the brain."
+ }
+}
\ No newline at end of file
diff --git a/absolute-beginners/frontend-beginner/javascript/index.mdx b/absolute-beginners/frontend-beginner/javascript/index.mdx
deleted file mode 100644
index e345ed2..0000000
--- a/absolute-beginners/frontend-beginner/javascript/index.mdx
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/absolute-beginners/frontend-beginner/javascript/intro-to-js.mdx b/absolute-beginners/frontend-beginner/javascript/intro-to-js.mdx
new file mode 100644
index 0000000..36fb85d
--- /dev/null
+++ b/absolute-beginners/frontend-beginner/javascript/intro-to-js.mdx
@@ -0,0 +1,125 @@
+---
+sidebar_position: 1
+title: "Hello JavaScript!"
+sidebar_label: Intro to JavaScript
+description: "The ultimate beginner's guide to starting your programming journey."
+---
+
+Think of your favorite website. When you click a "Like" button and the heart turns red, or when you type in a search bar and suggestions pop up that is **JavaScript** in action.
+
+### The Big Three: A Simple Analogy
+
+If building a website is like building a house:
+1. **HTML** is the **Structure** (The walls, doors, and windows).
+2. **CSS** is the **Decoration** (The paint, wallpaper, and furniture).
+3. **JavaScript** is the **Electricity & Plumbing** (The lights that turn on when you flip a switch and the water that flows when you turn a tap).
+
+## What is JavaScript, Exactly?
+
+JavaScript is a **Programming Language**. It allows you to tell the browser (Chrome, Safari, Edge) to do specific tasks. It is the most popular language in the world because it is the only language that runs natively in every web browser.
+
+### What can you do with it?
+
+* **Make things move:** Create animations or sliders.
+* **Handle Data:** Calculate a math problem or process a form.
+* **Update Content:** Change text or images without refreshing the page.
+* **Listen:** "Wait" for the user to click, scroll, or type.
+
+## Where Do We Write JavaScript?
+
+You don't need fancy software to start. You just need a text editor and a browser. There are three ways to add JS to your site:
+
+### 1. The Console (The Secret Playground)
+
+Every browser has a hidden "Console" for developers to test code.
+* **Try it:** Right-click this page -> **Inspect** -> Click the **Console** tab.
+* Type `alert("Hello World");` and hit Enter.
+
+### 2. Internal (The Script Tag)
+
+You can write code directly inside your HTML file using the `
+```
+
+### 3. External (The Professional Way)
+
+Just like CSS, we keep our JavaScript in its own file (e.g., `script.js`). This keeps our project clean.
+
+> Create a file named `script.js` and link it at the very bottom of your HTML, just before the closing `
+ Welcome to JS!
+
+
+