# 🎯 Project Spec: VSCode Theme

## Overview
A custom VS Code theme designed for students. Not too dark, not too bright — optimized for long coding sessions with good syntax highlighting and eye comfort.

**Target Users**: Student developers, beginners
**Impact Goal**: 1,000+ installs on VS Code Marketplace
**Time to Build**: 1-2 weeks

---

## Impact First

### Problem
- Default VS Code themes aren't optimized for students
- Dark+ themes can be too harsh
- Syntax highlighting isn't educational

### Impact
- **Installs**: 1,000+ installs
- **Reviews**: 20+ positive reviews
- **Community**: GitHub stars

### Leadership
- Contributing to the developer community
- Open source best practices

---

## Technical Stack

| Component | Technology | Cost |
|-----------|------------|------|
| Extension | VS Code Extension API | $0 |
| Publishing | VS Code Marketplace | $0 |
| Repository | GitHub | $0 |

---

## Features

### MVP
1. **Editor Colors**: Syntax highlighting optimized for learning
2. **UI Colors**: Sidebar, status bar, tabs
3. **Token Colors**: Clear distinction between keywords, strings, etc.
4. **Light + Dark**: Both variants

### Version 2
1. **File Icons**: Custom icons
2. **Localization**: i18n ready
3. **Accessibility**: WCAG contrast compliant

---

## Color Palette

### Dark (Key Philosophy)
- Background: `#1e1e2e` (soft dark, not pure black)
- Text: `#cdd6f4` (easy on eyes)
- Keywords: `#cba6f7` (purple, friendly)
- Strings: `#a6e3a1` (green, positive)
- Functions: `#89b4fa` (blue, clear)
- Variables: `#f5c2e7` (pink, warm)
- Comments: `#6c7086` (gray, subtle)

### Light
- Background: `#eff1f5`
- Text: `#4c4f69`
- Keywords: `#8839ef`
- Strings: `#40a02b`
- Functions: `#1e66f5`

---

## Implementation

### Week 1: Theme Development
- [ ] Study 10+ popular themes
- [ ] Define color palette
- [ ] Create JSON theme file
- [ ] Test in VS Code
- [ ] Get feedback from 5 users

### Week 2: Publishing
- [ ] Create GitHub repo
- [ ] Write README with screenshots
- [ ] Publish to Marketplace
- [ ] Share on Reddit/Hacker News
- [ ] Track installs

---

## Metrics

| Metric | Target |
|--------|--------|
| Installs | 1,000+ |
| Ratings | 4.5+ |
| GitHub Stars | 50+ |

---

## How to Demo

### Video
1. Show the problem (boring default themes)
2. Show your solution (the colors, the philosophy)
3. Show the code (JSON theme file structure)
4. Show metrics (installs, reviews)

### Essay Angle
- "I stared at code for 6 hours a day and hated my theme"
- "I asked 20 students what they wanted"
- "I learned about color theory, accessibility, and open source"
- "Now 1,000+ students use my theme"

---

## Extension Ideas

1. **Extension Pack**: Theme + icons + settings sync
2. **Emacs/Neovim Port**: Convert to other editors
3. **Dynamic Theme**: Time-based color adjustment

---

*Spec completed: 2026-04-28*

*Generated by Hermes Babu*