diff --git a/docs/docs.json b/docs/docs.json
index 272b598a..5764821a 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -1,14 +1,45 @@
{
"$schema": "https://mintlify.com/docs.json",
"theme": "maple",
+ "appearance": {
+ "default": "dark",
+ "strict": true
+ },
"name": "33 JavaScript Concepts",
- "description": "33 concepts every JavaScript developer should know",
+ "description": "Learn JavaScript with 33 essential concepts every developer should know. Free guide with clear explanations, practical code examples, and curated resources.",
"colors": {
- "primary": "#F7DF1E",
- "light": "#FAFAFA",
- "dark": "#1A1A1A"
+ "primary": "#F0DB4F",
+ "light": "#F0DB4F",
+ "dark": "#C9B83C"
+ },
+ "favicon": "/favicon.ico",
+ "seo": {
+ "indexing": "navigable",
+ "metatags": {
+ "og:type": "website",
+ "og:site_name": "33 JavaScript Concepts",
+ "og:locale": "en_US",
+ "og:image": "/og-image.png",
+ "twitter:card": "summary_large_image",
+ "twitter:site": "@leonardomso",
+ "twitter:creator": "@leonardomso",
+ "twitter:image": "/og-image.png",
+ "author": "Leonardo Maldonado",
+ "keywords": "JavaScript, JS, learn JavaScript, JavaScript tutorial, JavaScript concepts, JavaScript fundamentals, web development, programming, coding, closures, promises, async await, event loop, DOM, prototypes",
+ "language": "en",
+ "coverage": "Worldwide",
+ "distribution": "global",
+ "rating": "general",
+ "revisit-after": "7 days",
+ "category": "Technology, Education, Programming"
+ }
+ },
+ "search": {
+ "prompt": "Search concept..."
+ },
+ "metadata": {
+ "timestamp": true
},
- "favicon": "/favicon.svg",
"navbar": {
"links": [
{
diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644
index 00000000..4cfbbe41
Binary files /dev/null and b/docs/favicon.ico differ
diff --git a/docs/index.mdx b/docs/index.mdx
index 03ddb476..49f290de 100644
--- a/docs/index.mdx
+++ b/docs/index.mdx
@@ -1,98 +1,92 @@
---
-title: "33 JavaScript Concepts Every Developer Should Know"
+title: "33 JavaScript Concepts - Learn JS Fundamentals in 2025"
sidebarTitle: "Welcome"
-description: "Learn the 33 essential JavaScript concepts every developer needs. Free guide with explanations, code examples, and curated resources for all skill levels."
+description: "Learn JavaScript with 33 essential concepts every developer should know. Free guide with clear explanations, practical code examples, and curated resources for beginners to senior developers."
---
-
-
-
33 JavaScript Concepts
-
- Every JavaScript developer should know these fundamental concepts
-
-
-
-
+Want to truly understand how JavaScript works? Not just copy-paste code, but actually know what's happening under the hood?
----
+These 33 concepts are the foundation. Whether you're debugging a tricky closure, optimizing async code, or preparing for technical interviews, this is the knowledge that separates developers who struggle from those who ship with confidence.
-JavaScript is the language of the web. Whether you're just starting out or have years of experience, understanding these 33 core concepts will make you a stronger developer. This guide breaks down each topic with clear explanations, practical code examples, and hand-picked resources to help you learn.
+
+**What you'll find in this guide:**
+- Clear explanations written for humans, not textbooks
+- Practical code examples you can run and modify
+- Visual diagrams that make abstract concepts click
+- Curated resources (articles, videos, docs) for deeper learning
+- Knowledge checks to test your understanding
+
---
-## Why These 33 Concepts?
+## Who Is This For?
-This isn't just another tutorial. It's a roadmap to truly understanding how JavaScript works under the hood. Whether you're building websites, mobile apps, or servers, these concepts are the foundation.
+This guide meets you where you are. Whether you're writing your first line of JavaScript or you've been shipping code for years, there's something here for you.
-
- No prior JavaScript knowledge required. Start from the fundamentals and build a solid foundation.
+
+ New to JavaScript? Start from the fundamentals and build real understanding, not just syntax memorization.
-
- Fill in the gaps and deepen your understanding of concepts you use every day.
+
+ Fill the gaps in your knowledge. Finally understand the "why" behind patterns you've been using.
-
- These concepts are commonly asked in technical interviews. Be ready to explain them.
+
+ These concepts come up constantly in technical interviews. Know them cold.
-
- Available in 40+ languages thanks to our community of contributors.
+
+ Solidify your mental models. Teach others with confidence.
---
-## What You'll Learn
+## The 33 Concepts
+
+Each concept builds on the others. Start from the beginning or jump to what you need. Every page includes explanations, code examples, and resources to go deeper.
- Types, Scope, Closures, Call Stack, and how JavaScript really works
+ Types, Scope, Closures, Call Stack, and how JavaScript actually executes your code
- Event Loop, IIFE, Modules, and how code gets executed
+ The Event Loop, IIFE, Modules, and why JavaScript can be both single-threaded and non-blocking
- DOM manipulation, HTTP requests with Fetch, and Web Workers
+ DOM manipulation, HTTP requests with Fetch, and Web Workers for background processing
- Classes, Prototypes, `this` keyword, and inheritance
+ Classes, Prototypes, the `this` keyword, and how inheritance really works
- Callbacks, Promises, async/await, and handling asynchronous code
+ Callbacks, Promises, async/await, and patterns for handling asynchronous operations
- Pure functions, Higher-order functions, map/reduce/filter, and recursion
+ Pure functions, Higher-order functions, map/reduce/filter, recursion, and composition
- Data structures, Algorithms, Design patterns, and clean code
+ Data structures, Algorithms, Design patterns, and writing clean, maintainable code
---
-## A Community Effort
+## A Community Project
-**Recognized by GitHub** as one of the [top open source projects of 2018](https://github.blog/news-insights/octoverse/new-open-source-projects/#top-projects-of-2018)!
+**Recognized by GitHub** as one of the [top open source projects of 2018](https://github.blog/news-insights/octoverse/new-open-source-projects/#top-projects-of-2018).
-This project was created by [Leonardo Maldonado](https://github.com/leonardomso) and has grown through contributions from hundreds of developers worldwide. It has been translated into over 40 languages, making JavaScript education accessible to everyone.
+Created by [Leonardo Maldonado](https://github.com/leonardomso) and improved by hundreds of contributors worldwide. Translated into 40+ languages, making JavaScript education accessible to developers everywhere.
---
-## Ready to Begin?
+## Start Learning
-
- Learn about the project's origin and what makes it different
+
+ The story behind the project and how to get the most out of it
-
- Jump straight into the first concept
+
+ Start with Primitive Types and work your way through
diff --git a/docs/og-image.png b/docs/og-image.png
new file mode 100644
index 00000000..e5a1294a
Binary files /dev/null and b/docs/og-image.png differ
diff --git a/github-image.png b/github-image.png
index a50560fd..e5a1294a 100644
Binary files a/github-image.png and b/github-image.png differ