Spectral code cemetery

A haunting web application that "resurrects" code from Git history, analyzes it using AI, and presents it through an eerie, cemetery-themed interface where code lives in gravestones .

Comment

🎃 SPECTRAL Code Cemetery - DevPost Submission

Project Information

Project Title: SPECTRAL Code Cemetery - Visualize Your Dead Code with AI Tagline: Turn abandoned code into a haunted cemetery with AI narratives Categories:

  • Primary: 🧟‍♂️ Resurrection
  • Secondary: 🎭 Costume Contest ## 💀 Inspiration

Every developer has encountered "dead code" - files that haven't been touched in months or years, sitting forgotten in repositories. We've all wondered: What happened to this code? Why was it abandoned? Who worked on it last?

Traditional Git analysis tools show dry statistics and commit logs. We wanted something different - something that would make exploring code history fun, memorable, and insightful.

The Halloween theme was perfect: dead code becomes tombstones, contributors become ghosts, and AI breathes life into forgotten files by telling their stories. We're literally resurrecting dead code by visualizing it in a haunted cemetery and using AI to suggest how to modernize it.

👻 What it does

SPECTRAL Code Cemetery transforms Git repositories into an interactive haunted cemetery where:

Core Features

🪦 Cemetery Visualization

  • Each file appears as a tombstone in an interactive graveyard
  • Tombstone size and color reflect commit activity and code health
  • Click any tombstone to see detailed file history and statistics

👻 Ghost Contributors

  • Contributors float as translucent ghost avatars
  • Hover over ghosts to see their commit statistics and activity
  • AI generates unique "ghost personas" for each contributor

📜 AI-Powered Epitaphs

  • Google Gemini AI writes spooky epitaphs for abandoned files
  • Each epitaph tells the story of how the code "died"
  • Creative narratives make code history memorable and engaging

⏰ Time Travel

  • Navigate through Git history visually
  • See how files evolved over time
  • Watch the cemetery change as you travel through commits

🔮 Code Resurrection

  • AI analyzes old code and suggests modernization
  • Get recommendations for bringing legacy code up to current standards
  • Practical suggestions for refactoring and improvements

🎨 Haunting UI/UX

  • Smooth animations with Framer Motion
  • Fog effects and floating particles
  • Responsive design that works on all devices
  • Consistent Halloween theme throughout

🛠️ How I built it

Technology Stack

Frontend:

  • React 18 - Modern UI framework
  • Vite - Lightning-fast build tool
  • TailwindCSS - Utility-first styling with custom Halloween theme
  • Framer Motion - Smooth animations for ghosts and tombstones
  • React Query - Server state management and caching
  • Axios - HTTP client for API calls
  • Lucide React - Beautiful icon library

Backend:

  • Node.js + Express - RESTful API server
  • simple-git - Git repository analysis
  • Google Gemini AI - Creative narrative generation
  • Winston - Structured logging
  • node-cache - In-memory caching (5-minute TTL)
  • Joi - Request validation
  • Helmet - Security headers

Development Tools:

  • Kiro AI - Spec-driven development and code generation
  • Jest - Unit testing (43 passing tests)
  • Docker - Containerization for deployment
  • ESLint + Prettier - Code quality and formatting

Architecture

Full-Stack Application:

  1. Git Analysis Engine - Clones repositories, extracts commit history, analyzes file metadata
  2. AI Integration Layer - Generates epitaphs, ghost personas, and modernization suggestions
  3. REST API - 8 endpoints with rate limiting, validation, and caching
  4. Interactive Frontend - Cemetery visualization with smooth animations
  5. Caching System - Reduces API calls and improves performance

Development Process with Kiro AI

I used all 5 Kiro features to accelerate development:

  1. Spec-Driven Development (5 specs)
  2. Created comprehensive specifications before coding
  3. Defined architecture, API endpoints, and component structure

  4. Reduced refactoring and maintained consistency

  5. Steering Files (3 files)

  6. Enforced code standards across 100+ files

  7. Maintained Halloween theme consistency

  8. Automated best practices adherence

  9. Agent Hooks (3 hooks)

  10. Auto-commit on file save

  11. Component generator for rapid prototyping

  12. Test boilerplate generator

  13. MCP Integration (2 servers)

  14. GitHub server for repository management

  15. Code analyzer for quality checks

  16. Vibe Coding

  17. Natural conversation-driven development

  18. Iterative feature building

  19. Context-aware code generation

Result: Built a production-ready full-stack application in 20-25 hours (50% faster than traditional development).

🚧 Challenges I ran into

1. Git Repository Analysis Performance

Challenge: Analyzing large repositories (1000+ commits) was slow and memory-intensive. Solution:

  • Implemented shallow cloning with depth 1000
  • Limited file analysis to 500 files
  • Added in-memory caching with 5-minute TTL
  • Parallel processing for AI epitaph generation

2. Jest ES Modules Configuration

Challenge: Jest doesn't natively support ES modules, causing test failures. Solution:

  • Configured Jest with NODE_OPTIONS=experimental-vm-modules
  • Set up proper test environment with global utilities
  • Created custom test setup file
  • All 43 tests now passing with 85%+ coverage

3. AI Rate Limiting and Costs

Challenge: Google Gemini API has rate limits (60 RPM) and potential costs.

Solution:

  • Implemented graceful fallback responses
  • Batch processing with concurrency limits (10 at a time)
  • Aggressive caching (1-hour TTL for AI responses)
  • Limit epitaph generation to 50 files maximum

4. Cemetery Layout Algorithm

Challenge: Arranging tombstones naturally while preventing overlaps.

Solution:

  • CSS Grid with responsive columns (2-6 based on screen size)
  • Dynamic sizing based on commit count
  • Color-coding by churn rate (red = high activity, green = active, gray = stable)
  • Staggered entry animations for visual appeal

5. Maintaining Halloween Theme Consistency

Challenge: Keeping spooky theme consistent across 100+ files.

Solution:

  • Created comprehensive design system in steering files
  • Defined color palette, typography, and animation patterns
  • Used Kiro steering to enforce theme automatically
  • Result: Perfect consistency throughout

🏆 Accomplishments that I'm proud of

Technical Achievements

✅ Full-Stack Application in 20-25 Hours

  • Complete frontend and backend
  • 8 REST API endpoints
  • Interactive cemetery visualization
  • AI integration
  • Production-ready code

✅ 43 Passing Unit Tests (85%+ Coverage)

  • CacheService: 30 tests
  • Error handling: 13 tests
  • All tests passing with proper ES modules support

✅ Comprehensive Kiro Usage

  • Used ALL 5 Kiro features (Specs, Steering, Hooks, MCP, Vibe Coding)
  • 5 specification files
  • 3 steering files
  • 3 custom hooks
  • 2 MCP servers
  • Extensive documentation of Kiro impact

✅ Beautiful, Responsive UI

  • Smooth animations with Framer Motion
  • Consistent Halloween theme
  • Works on desktop, tablet, and mobile
  • Accessibility features (ARIA labels, keyboard navigation)

✅ Production-Ready Quality

  • Docker deployment
  • Error handling and logging
  • Security middleware
  • Rate limiting
  • Input validation
  • 15+ documentation files

Creative Achievements

✅ Unique Concept

  • Dead code as cemetery metaphor
  • AI-generated spooky narratives
  • Ghost personas for contributors
  • Time travel through Git history

✅ Practical Application

  • Solves real problem (technical debt identification)
  • Educational (learn about code history)
  • Entertaining (fun to explore)
  • Actionable (resurrection suggestions)

Personal Growth

✅ Learned Advanced Git Analysis

  • Deep dive into Git internals
  • Commit history parsing
  • File metadata extraction
  • Contributor analysis

✅ Mastered AI Integration

  • Prompt engineering for creative outputs
  • Handling rate limits and fallbacks
  • Parallel processing for performance
  • Caching strategies

✅ Improved React Skills

  • Framer Motion animations
  • React Query for server state
  • Custom hooks for reusable logic
  • Component composition patterns

✅ Discovered Kiro AI

  • Spec-driven development methodology
  • Steering files for consistency
  • Agent hooks for automation
  • 50% faster development

-

📚 What I learned

Technical Learnings

  1. Git Analysis is Complex
  2. Parsing commit history requires careful handling
  3. File metadata extraction needs optimization
  4. Contributor identification has edge cases

  5. Performance matters for large repositories

  6. AI Prompt Engineering is an Art

  7. Specific prompts yield better results

  8. Context matters for creative outputs

  9. Fallbacks are essential for reliability

  10. Caching saves costs and improves UX

  11. Animation Performance Matters

  12. Use transform and opacity for GPU acceleration

  13. Avoid animating width, height, top, left

  14. Stagger animations for visual appeal

  15. Respect prefers-reduced-motion

  16. Testing ES Modules is Tricky

  17. Jest requires special configuration

  18. Global utilities need proper setup

  19. Mocking ES modules differs from CommonJS

  20. Worth the effort for reliability

Development Process Learnings

  1. Spec-Driven Development Works
  2. Planning before coding saves time
  3. Clear architecture prevents refactoring
  4. Documentation stays up-to-date

  5. Team collaboration is easier

  6. Steering Files Enforce Consistency

  7. Automated best practices adherence

  8. Maintains theme across large codebase

  9. Reduces code review time

  10. Improves code quality

  11. Caching is Critical

  12. Reduces API calls and costs

  13. Improves user experience

  14. Enables offline functionality

  15. Requires careful invalidation strategy

  16. Error Handling is Essential

  17. Custom error classes improve debugging

  18. User-friendly messages enhance UX

  19. Logging helps troubleshooting

  20. Graceful degradation maintains functionality

Soft Skills Learnings

  1. Time Management
  2. Prioritize core features first
  3. Use tools (Kiro) to accelerate development
  4. Don't over-engineer

  5. Ship working software

  6. Creative Problem Solving

  7. Unique concepts stand out

  8. Practical + Fun = Memorable

  9. Theme consistency matters

  10. Details make the difference

  11. Documentation Matters

  12. Good docs help judges understand

  13. Clear README attracts users

  14. Comprehensive guides reduce support

  15. Professional presentation wins

-

🚀 What's next for SPECTRAL Code Cemetery

  1. GitHub OAuth Integration
  2. Authenticate with GitHub
  3. Access private repositories
  4. Save analysis history

  5. Favorite repositories

  6. Enhanced AI Features

  7. Code smell detection

  8. Refactoring suggestions

  9. Dependency analysis

  10. Security vulnerability scanning

  11. Export and Sharing

  12. Export cemetery as image

  13. Share via unique URL

  14. Embed in README files

  15. Social media integration

Medium-Term (3-6 Months)

  1. Real-Time Collaboration
  2. Multiple users exploring same repository
  3. Live cursor positions
  4. Shared annotations

  5. Team insights

  6. Advanced Analytics

  7. Code quality metrics

  8. Technical debt scoring

  9. Team productivity insights

  10. Trend analysis over time

  11. More Version Control Systems

  12. GitLab support

  13. Bitbucket support

  14. Azure DevOps support

  15. SVN support (for legacy projects)

Long-Term (6-12 Months)

  1. CI/CD Integration
  2. GitHub Actions integration
  3. Automatic analysis on commits
  4. Pull request comments

  5. Build status integration

  6. Database Persistence

  7. PostgreSQL for data storage

  8. User accounts and preferences

  9. Analysis history

  10. Saved searches

  11. Mobile App

  12. Native iOS app

  13. Native Android app

  14. Offline analysis

  15. Push notifications

  16. Enterprise Features

  17. Team management

  18. Role-based access control

  19. Custom branding

  20. On-premise deployment

  21. SLA guarantees

Community Features

  1. Public Cemetery Gallery
  2. Browse popular repositories
  3. Trending cemeteries
  4. Community ratings

  5. Featured projects

  6. Plugin System

  7. Custom analyzers

  8. Theme extensions

  9. Export formats

  10. Integration hooks

Built With

Share this project:

Updates