Quick Start

Last updated: 2026

What is CodeFun?

CodeFun is a locally-running Visual Studio Code extension that introduces playful, emotionally supportive micro-interventions directly into the IDE. Instead of distracting developers from work, CodeFun helps them cope with accumulated frustration during long coding sessions.

It does not enforce productivity, rigid schedules, or competitive gamification. It simply gives developers optional moments of fun.

Features

🔥 AI-powered Code Roast Generator
😂 Meme Viewer with controlled usage
👀 Eye Rest & Hydration Reminders
🧘 Stretch Break Prompts
⌨️ Typing Speed Graphs
🗺️ Keyboard Heatmap
🎯 Fun Points with basic streak tracking

Why use CodeFun?

Reduce monotony during long coding sessions
Encourage micro-breaks without breaking flow
Reflect on typing activity in real time
Add humor to debugging and development

How it works

CodeFun prompts a break reminder every 60 minutes (customizable). On confirmation, it guides the user through short relaxation steps and optionally allows meme breaks using earned Fun Points.

Typing Analytics and Code Roasts can be accessed anytime using the VS Code command palette.

Repository Structure

                    package.json  → Extension configuration

                    README.md     → Project documentation

                    src/

                    ├─ extension.js → Entry point

                    ├─ utils.js     → Common styles & helpers

                    └─ *.js         → Individual feature modules

How to Reproduce

Clone the repository
Run npm install
Open the folder in VS Code
Make any changes/extensions in code if required
Press F5 to launch Extension Development Host to test
Interact via Command Palette or automatic prompts

How to Use

Open VSCode
Click the Extensions icon in the Activity Bar
Select "Install from VSIX"
Select the .vsix file.
Restart VS Code to start using the extension
Interact via Command Palette or automatic prompts