The ultimate Chrome extension that answers the question: "How many classes can I safely bunk?"
MVP Philosophy: TCS already shows your attendance percentage - what you really need to know is how many classes you can skip while maintaining your target attendance!
- Large, prominent bunk calculator as the main feature
- Hero-sized result display showing exactly how many classes you can bunk
- Target percentage setting (default: 75% - adjustable)
- Real-time calculations with clear messaging: "You can safely skip X more classes!"
- Warning system if attendance is too low
- Zero-click data extraction from TCS iON portal
- Compact status indicator for detection progress
- Works across multiple TCS platforms (iON, Digital Academy, Fresco Play)
- Automatic refresh of data when popup opens
- Collapsible manual input (only shown if auto-detection fails)
- Input validation to prevent errors
- Data persistence using Chrome storage
- Quick update functionality
- Bunk-calculator-first visual hierarchy
- Compact 400px mobile-optimized layout
- Beautiful gradient interface with smooth animations
- Color-coded results (success/warning/danger states)
- Clean, intuitive user flow
- Download/Clone this repository
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" (top-right toggle)
- Click "Load unpacked" and select the
Bunk-matefolder - Pin the extension for easy access
# In Chrome Extensions page
# Click "Pack extension"
# Select Bunk-mate folder
# Install the generated .crx file- Open Extension → Immediately see "Calculate My Safe Bunks" button
- Auto-Detection → Extension pulls data from TCS (if on supported page)
- Set Target → Adjust minimum attendance % (default 75%)
- Calculate → Get instant answer: "You can bunk X classes!"
- Done → You have your answer in seconds!
- Open the extension on any page
- Expand manual input section (if auto-detection fails)
- Enter attendance data (classes attended / total classes)
- Click "Update Data"
- Use bunk calculator as normal
The smart algorithm calculates:
- Current attendance percentage
- Required classes to maintain target percentage
- Maximum safe bunks for future classes
- Warnings and recommendations based on current status
- ✅ Safe Zone: "You can bunk 8 more classes!"
⚠️ Warning Zone: "You need to attend 3 more classes first!"- ❌ Danger Zone: "You're at the minimum - can't bunk any more!"
- TCS iON (g21.tcsion.com, etc.)
- TCS Digital Academy (ion.digitalacademy.tcs.com)
- Fresco Play (fresco.tcs.com)
- TCS Corporate platforms
- Manual input works everywhere
Bunk-mate/
├── manifest.json # Extension configuration
├── popup-mvp.html # MVP-focused popup interface
├── src/
│ ├── scripts/
│ │ ├── content.js # TCS page data extraction
│ │ └── popup.js # Main popup logic (class-based)
│ ├── styles/
│ │ └── popup-mvp-focused.css # Bunk-calculator-first styling
│ └── assets/
│ ├── icon48.png # Extension icons
│ └── icon128.png
└── docs/ # Documentation
- Navigate to your TCS iON attendance page
- Click the Bunk Mate icon
- Verify auto-detection works
- Test bunk calculator with different target percentages
- Open extension on any page
- Expand manual input section
- Enter sample data (e.g., 45 attended, 60 total)
- Verify calculations are correct
- Very low attendance (below target)
- Perfect attendance (100%)
- Target percentage changes
- Invalid input handling
- ✅ MVP transformation: Bunk calculator as hero feature
- ✅ Streamlined UI: Compact, bunk-focused design
- ✅ Enhanced algorithm: Improved bunk calculation logic
- ✅ Clean codebase: Organized structure, removed duplicates
- ✅ Mobile-optimized: 400px responsive layout
- ✅ Auto-detection on popup open
- ✅ Redesigned UI with gradients
- ✅ Smart Bunk Calculator as main feature
- ✅ Removed debug files, improved performance
- ✅ Class-based architecture, modular code
- Not detecting data? → Ensure you're on a TCS iON attendance page
- Popup not opening? → Check if extension is enabled in chrome://extensions/
- Auto-detection failed? → Use manual input as fallback
- Wrong bunk count? → Verify input numbers and target percentage
- No result shown? → Check that attendance data is loaded first
- Unexpected warnings? → Review current attendance vs target percentage
- Slow loading? → Try refreshing the page and reopening extension
- Data not saving? → Check Chrome storage permissions
- Clone the repository
- Make changes to source files
- Test in Chrome developer mode
- Submit pull requests
- Use GitHub Issues for bug reports
- Include browser version and TCS platform details
- Provide steps to reproduce
- Content Script: Extracts data from TCS pages using multiple selectors
- Popup Script: Class-based architecture with error handling
- Storage: Chrome storage API for data persistence
- Permissions: Minimal required permissions for security
- Chrome 88+ (Manifest V3)
- Edge Chromium-based
- Other Chromium browsers
Made with ❤️ for students who want to bunk smartly!
- GitHub: @4-krishna & @devag7
- Issues: Use GitHub Issues for support
- Email: Available in GitHub profile
- Install → Load unpacked in Chrome extensions
- Open → Click extension icon on TCS page
- Calculate → Hit "Calculate My Safe Bunks"
- Bunk → Follow the recommendation safely!
⭐ Star this repo if Bunk Mate helped you plan your bunks smartly!
Remember: Use responsibly and maintain good attendance for your academic success! 🎓