🧭 Tell Your Project’s Story with StoryGuide Icons in VS Code

🔥 Give your folders meaning. Let your codebase speak.

If you’ve ever found yourself lost in a maze of folders while working in Visual Studio Code, you're not alone. Navigating large codebases can be a chore, especially when every folder looks the same. That's where StoryGuide Icons steps in — a fresh, narrative-driven take on file organization.

---

🚀 What Is StoryGuide Icons?

StoryGuide Icons is a free VS Code extension developed by Amanpandey that dynamically assigns emoji-based icons to folders based on their context, workflow role, and even current Git status. It turns your folder structure into a visual story — one that’s instantly readable and easy to follow.

---

🎯 Why You Should Try It

• 🧠 Context-Aware: Folders like src, test, or docs get meaningful icons like 💡, ✅, or 📚.

• 🔄 Dynamic: Icons update in real-time with Git changes or workflow stages.

• 🧭 Intuitive Navigation: Instantly recognize what each folder represents.

• 📖 Visual Storytelling: Your project becomes more than just code — it becomes a narrative.

• 🛠️ Customization (coming soon): Map your own icons and project types.

---

🔍 How Does It Work?

Behind the scenes, StoryGuide Icons:

• Analyzes folder names, some file contents, and Git metadata.

• Assigns relevant emojis to each folder.

• Updates icons automatically as your project evolves.

Example Mappings

---

⚙️ Getting Started

🧩 Installation

1. Open VS Code.

2. Launch Quick Open with Ctrl+P.

3. Paste this:

    ext install Amanpandey.storyguide-icons
   

4. Hit Enter and you're good to go.

🔧 Configuration Options

Go to Settings (Ctrl+,) and search for storyguide-icons:

• enableEmojiDecorations (default: true)

• projectTypePresets for future custom setups

---

🪄 Commands

• StoryGuide: Refresh Icons — Re-analyze and update all folder icons manually.

---

🤝 Want to Contribute?

You’re welcome to jump in with suggestions or pull requests. Let’s make VS Code friendlier — one emoji at a time.

🔗 [GitHub Repository (Coming Soon)]
📬 Reach out to @Amanpandey for ideas and feedback.

---

🔗 Share It, Star It, Use It

This extension is a must-have for:

• Frontend and backend devs

• Students organizing messy project folders

• Teams who want visual clarity

• Anyone who lives in VS Code and loves efficiency

→ Try it now and bring your project to life.