{"id":30804898,"url":"https://github.com/tolinsimpson/productivity-tools","last_synced_at":"2025-10-09T19:05:25.279Z","repository":{"id":312150574,"uuid":"1046426321","full_name":"TolinSimpson/productivity-tools","owner":"TolinSimpson","description":"A productivity Tool Suite for web, mobile \u0026 desktop.","archived":false,"fork":false,"pushed_at":"2025-08-29T16:47:32.000Z","size":268,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-06T00:39:04.989Z","etag":null,"topics":["checklist","encyrption","html-css-javascript","javascript","notes-app","productivity","pwa","timer","tools","wysiwyg-editor"],"latest_commit_sha":null,"homepage":"https://tolinsimpson.github.io/productivity-tools/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TolinSimpson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-28T17:08:39.000Z","updated_at":"2025-08-31T11:39:42.000Z","dependencies_parsed_at":"2025-08-29T01:59:59.439Z","dependency_job_id":"c3ca3a82-5f26-4314-abf3-6df124d98346","html_url":"https://github.com/TolinSimpson/productivity-tools","commit_stats":null,"previous_names":["tolinsimpson/productivity-tools"],"tags_count":0,"template":false,"template_full_name":"TolinSimpson/PWA-Template","purl":"pkg:github/TolinSimpson/productivity-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolinSimpson%2Fproductivity-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolinSimpson%2Fproductivity-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolinSimpson%2Fproductivity-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolinSimpson%2Fproductivity-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TolinSimpson","download_url":"https://codeload.github.com/TolinSimpson/productivity-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TolinSimpson%2Fproductivity-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001983,"owners_count":26083243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["checklist","encyrption","html-css-javascript","javascript","notes-app","productivity","pwa","timer","tools","wysiwyg-editor"],"created_at":"2025-09-06T00:28:53.693Z","updated_at":"2025-10-09T19:05:25.263Z","avatar_url":"https://github.com/TolinSimpson.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Productivity Suite\r\n\r\nA comprehensive Progressive Web App combining multiple productivity tools with encrypted storage, cloud sync, and offline support.\r\n\r\n## ✨ Features\r\n\r\n- 📝 **Notes Management**: Rich text editor with markdown support and organization\r\n- 🕒 **Pomodoro Timer**: Focus sessions with customizable work/break intervals\r\n- ☑️ **Smart Checklists**: Task management with priority levels and completion tracking\r\n- 📊 **Eisenhower Matrix**: Task prioritization using the urgent/important framework\r\n- 📅 **Calendar \u0026 Events**: Full-featured calendar with event management and scheduling\r\n- ☁️ **Cloud Sync**: Automatic synchronization with Google Drive, OneDrive, and Dropbox\r\n- 🔐 **Encrypted Storage**: AES-256-GCM encryption for all your data\r\n- 📱 **Mobile Ready**: Responsive design optimized for all devices\r\n- 📲 **Installable**: Works as a native app experience\r\n- ⚡ **Fast \u0026 Offline**: Service worker caching for offline functionality\r\n- 🎨 **Modern UI**: Clean, intuitive interface with dark/light theme support\r\n- 🔧 **Zero Dependencies**: Pure HTML, CSS, and JavaScript\r\n\r\n## 🛠️ Tools Included\r\n\r\n### 📝 Notes System\r\n- **Rich Text Editor**: Full-featured markdown editor with live preview\r\n- **Notes List**: Organize and search through all your notes\r\n- **Categories \u0026 Tags**: Flexible organization system\r\n- **Export/Import**: Backup and restore your notes\r\n- **Encryption**: Optional password protection for sensitive notes\r\n\r\n### 🕒 Pomodoro Timer\r\n- **Customizable Sessions**: Set your own work and break durations\r\n- **Visual Progress**: Clean countdown with progress indicators\r\n- **Audio Notifications**: Configurable sound alerts\r\n- **Session Tracking**: Monitor your productivity sessions\r\n- **Auto-Start Options**: Seamless transitions between work and breaks\r\n\r\n### ☑️ Checklist Manager\r\n- **Smart Task Lists**: Create and manage multiple checklists\r\n- **Priority Levels**: High, medium, low priority classification\r\n- **Due Dates**: Set deadlines and get reminders\r\n- **Progress Tracking**: Visual completion indicators\r\n- **Categories**: Organize tasks by project or context\r\n\r\n### 📊 Eisenhower Matrix\r\n- **Quadrant System**: Organize tasks by urgency and importance\r\n- **Drag \u0026 Drop**: Easy task movement between quadrants\r\n- **Color Coding**: Visual priority identification\r\n- **Action Planning**: Built-in guidance for each quadrant\r\n- **Export Views**: Save your matrix as images or data\r\n\r\n### 📅 Calendar \u0026 Event Manager\r\n- **Full Calendar View**: Monthly, weekly, and daily calendar views\r\n- **Event Management**: Create, edit, and delete events with rich details\r\n- **Priority System**: High, medium, low priority events with color coding\r\n- **Recurring Events**: Set up repeating events and schedules\r\n- **Event Categories**: Organize events by type (work, personal, meetings, etc.)\r\n- **Time Slots**: Drag and drop events in weekly view\r\n- **Search \u0026 Filter**: Find events quickly with search and filtering\r\n- **Export Options**: Export calendar data and event lists\r\n\r\n### ☁️ Cloud Storage \u0026 Sync\r\n- **Smart Browser Detection**: Automatically detects your browser and preferred cloud provider\r\n- **Multi-Provider Support**: Works with Google Drive (Chrome), OneDrive (Edge), Dropbox, iCloud (Safari)\r\n- **Browser-Native Sync**: Uses File System Access API for seamless integration\r\n- **Background Auto-Sync**: Continuous synchronization running in background iframe\r\n- **Automatic Sync**: Set up automatic synchronization every 5-60 minutes with initial sync delay\r\n- **Encrypted Sync**: All data encrypted before syncing to cloud\r\n- **Complete Backup**: Full export of all productivity tools data\r\n- **Cross-Device Access**: Access your data from any device with cloud sync\r\n- **Offline Support**: Works offline with sync when connection is restored\r\n- **Conflict Resolution**: Smart handling of data conflicts during sync\r\n- **Status Indicators**: Real-time sync status displayed in main app\r\n- **Provider Optimization**: Chrome → Google Drive, Edge → OneDrive, Safari → iCloud, Firefox → Dropbox\r\n\r\n### ⚙️ Settings \u0026 Data Management\r\n- **Theme Selection**: Light, dark, and auto modes\r\n- **Data Export**: Complete backup of all your data\r\n- **Import Tools**: Restore from previous backups\r\n- **Storage Inspector**: View and manage encrypted data\r\n- **Security Settings**: Configure encryption and passwords\r\n- **Cloud Settings**: Manage sync preferences and cloud connections\r\n\r\n## 📁 Project Structure\r\n\r\n```\r\nproductivity-tools/\r\n├── index.html              # Main app shell with navigation\r\n├── styles.css              # Global styles and themes\r\n├── app.js                  # Core app functionality and routing\r\n├── encrypted-storage.js    # AES-256 encryption utilities\r\n├── cloud-auth.js           # Cloud storage sync manager\r\n├── service-worker.js       # Offline caching and PWA features\r\n├── manifest.json           # PWA configuration\r\n├── update-version.js       # Version update script for deployments\r\n├── notes-list.html         # Notes management interface\r\n├── note-editor.html        # Rich text note editor\r\n├── pomodoro.html           # Pomodoro timer tool\r\n├── checklist.html          # Task and checklist manager\r\n├── eisenhower.html         # Eisenhower Matrix interface\r\n├── calendar.html           # Calendar and event manager\r\n├── settings.html           # Settings and data management\r\n├── icons/                  # App icons and graphics\r\n│   ├── icon-192x192.png\r\n│   ├── icon-512x512.png\r\n│   └── *.svg\r\n├── LICENSE                 # The Unlicense\r\n└── README.md              # This documentation\r\n```\r\n\r\n## 🔄 Update System\r\n\r\nThe PWA includes an intelligent update system that ensures users always get the latest version:\r\n\r\n### Automatic Updates\r\n- **Version-based Caching**: Each deployment uses a unique cache name based on version\r\n- **Network-First Strategy**: Always tries to fetch fresh content from the server\r\n- **Update Detection**: Automatically detects when new versions are available\r\n- **Periodic Checks**: Checks for updates every hour in the background\r\n- **User Notifications**: Shows update notifications when new versions are ready\r\n\r\n### Manual Update Check\r\n- **Settings Page**: \"Check for Updates\" button in the settings\r\n- **Immediate Refresh**: Users can apply updates immediately\r\n- **Status Feedback**: Clear indication of update status and progress\r\n\r\n### Deployment Process\r\n1. **Update Version**: Run `node update-version.js v1.0.5` (replace with new version)\r\n2. **Test Locally**: Verify changes work as expected\r\n3. **Commit \u0026 Push**: Push to GitHub repository\r\n4. **Auto-Deploy**: GitHub Pages automatically deploys the update\r\n5. **User Updates**: Users see update notifications on next visit\r\n\r\n### Version Management\r\n- **Service Worker**: Cache version in `service-worker.js`\r\n- **Manifest**: App version in `manifest.json`\r\n- **Synchronized**: Both files updated together via script\r\n- **Semantic Versioning**: Follows vX.Y.Z format (e.g., v1.0.5)\r\n\r\n## 🚀 Quick Start\r\n\r\n1. **Access Online**: Visit the [live app](https://your-username.github.io/productivity-tools)\r\n\r\n2. **Install as App**:\r\n   - **Desktop**: Click the install button in your browser's address bar\r\n   - **Mobile**: Use \"Add to Home Screen\" from your browser menu\r\n\r\n3. **Local Development**:\r\n   ```bash\r\n   # Clone the repository\r\n   git clone \u003crepository-url\u003e\r\n   cd productivity-tools\r\n   \r\n   # Start a local server\r\n   python -m http.server 8000\r\n   # or\r\n   npx serve .\r\n   \r\n   # Open http://localhost:8000\r\n   ```\r\n\r\n4. **Start Being Productive**:\r\n   - 📝 Create your first note in the Notes section\r\n   - 🕒 Start a Pomodoro session to focus\r\n   - ☑️ Add tasks to your checklist\r\n   - 📊 Organize priorities in the Eisenhower Matrix\r\n\r\n## 💾 Data Security \u0026 Storage\r\n\r\n### Encrypted Storage\r\nAll your data is encrypted using AES-256-GCM encryption before being stored locally or synced to cloud:\r\n\r\n```javascript\r\n// Your data is automatically encrypted\r\nconst notes = await storage.loadEncrypted('notes');\r\nawait storage.saveEncrypted('notes', updatedNotes);\r\n\r\n// Optional password protection for extra security\r\nawait storage.saveEncrypted('sensitive-note', data, 'your-password');\r\n\r\n// Cloud sync with encryption\r\nawait cloudManager.syncToCloud(); // Automatically encrypts before sync\r\n```\r\n\r\n### Privacy First\r\n- **Local Storage**: All data stays on your device\r\n- **No Tracking**: No analytics or user tracking\r\n- **Offline Capable**: Works completely offline\r\n- **Export Control**: You own and control your data\r\n\r\n### Backup \u0026 Restore\r\n- **Full Export**: Download all your data as encrypted backup\r\n- **Selective Export**: Export specific tools or date ranges\r\n- **Easy Import**: Restore from backup files\r\n- **Cross-Device**: Move your data between devices securely\r\n- **Cloud Sync**: Automatic backup to Google Drive, OneDrive, or Dropbox\r\n- **Auto-Sync**: Set up automatic synchronization every 5-60 minutes\r\n- **Conflict Resolution**: Smart handling of data conflicts during sync\r\n\r\n## 📱 Progressive Web App Features\r\n\r\n✅ **Installable**: Add to home screen on any device  \r\n✅ **Offline Support**: Works without internet connection  \r\n✅ **Fast Loading**: Cached for instant startup  \r\n✅ **Native Feel**: App-like experience and navigation  \r\n✅ **Responsive**: Optimized for mobile, tablet, and desktop  \r\n✅ **Secure**: HTTPS required, encrypted storage  \r\n\r\n## 🎯 Usage Tips\r\n\r\n### Getting Started\r\n1. **Begin with Notes**: Start by creating some notes to get familiar\r\n2. **Try Pomodoro**: Use the timer for focused work sessions\r\n3. **Plan with Matrix**: Use Eisenhower Matrix for task prioritization\r\n4. **Track with Checklists**: Manage daily tasks and projects\r\n5. **Schedule with Calendar**: Add events and manage your schedule\r\n6. **Set up Cloud Sync**: Connect to your cloud storage for backup and cross-device access\r\n\r\n### Best Practices\r\n- **Regular Backups**: Export your data weekly or enable cloud sync for automatic backups\r\n- **Use Categories**: Organize notes, tasks, and events by project\r\n- **Set Passwords**: Use password protection for sensitive data\r\n- **Customize Settings**: Adjust themes, timer preferences, and sync frequency\r\n- **Stay Focused**: Use Pomodoro technique for better concentration\r\n- **Calendar Integration**: Sync your calendar with other productivity tools\r\n- **Cloud Sync**: Enable automatic sync for seamless cross-device access\r\n\r\n### Keyboard Shortcuts\r\n- **Ctrl/Cmd + S**: Save current item\r\n- **Ctrl/Cmd + N**: Create new item\r\n- **Ctrl/Cmd + E**: Export data\r\n- **Ctrl/Cmd + /**: Search/filter\r\n- **Esc**: Close modals and return to main view\r\n\r\n## 🛠️ Customization\r\n\r\n### Themes\r\n- **Light Mode**: Clean, minimal design\r\n- **Dark Mode**: Easy on the eyes for long sessions\r\n- **Auto Mode**: Follows system preference\r\n\r\n### Pomodoro Settings\r\n- **Work Duration**: Default 25 minutes (customizable)\r\n- **Short Break**: Default 5 minutes (customizable)\r\n- **Long Break**: Default 15 minutes (customizable)\r\n- **Auto-Start**: Automatic session transitions\r\n\r\n### Data Management\r\n- **Storage Backend**: Automatically selects best available option\r\n- **Encryption Level**: AES-256-GCM with fallbacks\r\n- **Export Formats**: JSON, CSV, and encrypted backups\r\n- **Cloud Providers**: Google Drive, OneDrive, Dropbox, and any cloud storage\r\n- **Sync Frequency**: Configurable from 5 minutes to 1 hour\r\n- **Calendar Views**: Monthly, weekly, and daily calendar layouts\r\n\r\n## 🌐 Browser Support\r\n\r\n- ✅ **Chrome/Chromium**: Full support with all features\r\n- ✅ **Firefox**: Complete compatibility\r\n- ✅ **Safari**: Full support including iOS\r\n- ✅ **Edge**: Modern Edge with full PWA support\r\n- ⚠️ **Older Browsers**: Basic functionality with encryption fallbacks\r\n\r\n## 🚀 Deployment\r\n\r\nThe app is designed to work on any web server supporting HTTPS:\r\n\r\n1. **GitHub Pages**: Automatic deployment from main branch\r\n2. **Netlify/Vercel**: Drop the folder for instant deployment\r\n3. **Your Server**: Upload files to any HTTPS-enabled web server\r\n\r\n### Deploy to GitHub Pages\r\n1. Fork or clone this repository\r\n2. Enable GitHub Pages in repository settings\r\n3. Select \"Deploy from branch\" and choose `main` branch\r\n4. Your app will be available at `https://username.github.io/productivity-tools`\r\n\r\n## 🔧 Development\r\n\r\n### Adding New Tools\r\n1. Create a new HTML file for your tool (e.g., `my-tool.html`)\r\n2. Add navigation button in `index.html`\r\n3. Update the routing in `app.js`\r\n4. Add styles in `styles.css`\r\n5. Update service worker cache list\r\n6. Integrate with cloud sync in `cloud-auth.js` if needed\r\n\r\n### Modifying Existing Tools\r\n- Each tool is self-contained in its HTML file\r\n- Shared functionality is in `app.js` and `encrypted-storage.js`\r\n- Styles are organized by component in `styles.css`\r\n\r\n### Testing\r\n- Use browser DevTools Application tab for PWA debugging\r\n- Test offline functionality by disabling network\r\n- Run Lighthouse audit for performance and PWA compliance\r\n- Test installation on various devices and browsers\r\n\r\n## 📄 License\r\n\r\nThis project is licensed under the [MIT License](https://opensource.org/licenses/MIT). You are free to use, modify, distribute, or sell this software for any purpose, provided that the original copyright and license notice are included.\r\n\r\n## 🤝 Contributing\r\n\r\nThis productivity suite is designed to be simple and focused. If you'd like to contribute:\r\n\r\n1. Keep tools simple and focused on core functionality\r\n2. Maintain the encrypted storage pattern\r\n3. Ensure mobile responsiveness\r\n4. Follow the existing UI/UX patterns\r\n5. Test across different browsers and devices\r\n\r\n---\r\n\r\n**Start boosting your productivity today!** 🚀","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolinsimpson%2Fproductivity-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftolinsimpson%2Fproductivity-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftolinsimpson%2Fproductivity-tools/lists"}