https://github.com/carloscommits/betterbudgyt
https://github.com/carloscommits/betterbudgyt
Last synced: 29 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/carloscommits/betterbudgyt
- Owner: CarlosCommits
- Created: 2025-01-24T19:49:40.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-01-12T16:10:13.000Z (6 months ago)
- Last Synced: 2026-01-12T21:53:55.596Z (5 months ago)
- Language: JavaScript
- Size: 2.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# BetterBudgyt Chrome Extension
A Chrome extension that enhances Budgyt.com dashboards with customizable variance calculations and improved data visualization.
## Quick Installation Guide
1. **Download the Extension**
- Download this repository as a ZIP file
- Extract the ZIP file to a location on your computer
2. **Install in Chrome**
- Open Chrome and go to `chrome://extensions/`
- Enable "Developer mode" in the top-right corner
- Click "Load unpacked" in the top-left
- Select the extracted extension folder
- The BetterBudgyt icon should appear in your Chrome toolbar
3. **Verify Installation**
- The BetterBudgyt icon should appear in your Chrome toolbar
- Click the icon to open the settings popup
- Visit any Budgyt dashboard page to see the extension in action
## Quick Start Guide
1. **Configure Variance Calculations**
- Click the BetterBudgyt icon in your toolbar
- Select your desired columns for variance calculations
- Changes are saved automatically
2. **Using Total-Only View**
- Open any DataInput page in Budgyt
- Click the BetterBudgyt icon
- Toggle "Show Total Only" for a simplified view
3. **Understanding Visual Indicators**
- Modified cells have a subtle highlight
- Hover over rows for enhanced visibility
- Headers show current calculation formulas
## Features
### Variance Calculations
- Customize which columns to use in variance calculations
- Real-time updates as you make changes
- Support for all budget data levels
- Dynamic percentage calculations
### DataInput View Optimization
- Toggle between full and total-only views
- Simplified data presentation
- Preserved total column functionality
### User-Friendly Interface
- Intuitive settings configuration
- Visual indicators for modified cells
- Settings persist across sessions
### Data Safety
- Works entirely client-side
- No data is sent to servers
- Original Budgyt data remains unchanged
## Troubleshooting
### Extension Not Working?
1. Ensure you're on a Budgyt dashboard page (https://*.budgyt.com/*)
2. Check if the extension is enabled in chrome://extensions/
3. Try refreshing the page
4. Disable and re-enable the extension if needed
### Settings Not Saving?
1. Check if Chrome sync is enabled
2. Try removing and re-adding the extension
3. Clear extension storage and reconfigure
### Visual Issues?
1. Refresh the page
2. Ensure no other extensions are conflicting
3. Check if your Budgyt page is fully loaded
## Technical Details
### Built With
- Chrome Extension APIs (Manifest V3)
- Native JavaScript (ES6+)
- HTML5 & CSS3
### Permissions Used
- `storage`: Saves your settings
- `activeTab`: Accesses current page
- `scripting`: Performs calculations
- Access to `*.budgyt.com` domains
### Architecture
- Client-side operations only
- Uses MutationObserver for real-time updates
- Implements precise CSS selectors
## Development
### Project Structure
```
├── manifest.json # Extension configuration
├── popup.html # Settings interface
├── popup.js # Settings logic
├── content.js # Main functionality
├── styles.css # Custom styling
└── images/ # Extension icons
```
### Building from Source
1. Clone the repository
2. Run `npm install`
3. Make desired modifications
4. Test locally using Chrome's developer mode
5. Run `npm run build` to create a zip for local testing
### Releasing a New Version
Releases are automated via GitHub Actions:
```bash
npm run release:patch # 1.5.0 → 1.5.1 (bug fixes)
npm run release:minor # 1.5.0 → 1.6.0 (new features)
npm run release:major # 1.5.0 → 2.0.0 (breaking changes)
```
This bumps the version, commits, tags, pushes, and GitHub Actions automatically uploads to the Chrome Web Store.
### Contributing
- Fork the repository
- Create a feature branch
- Submit a pull request
## Future Enhancements
- Additional column combination support
- Custom formatting options
- Export/import settings
- Calculation presets
- Enhanced data validation