{"id":30211956,"url":"https://github.com/devteds/noteflo-vscode-extension","last_synced_at":"2026-06-29T11:31:40.137Z","repository":{"id":306839144,"uuid":"1027000407","full_name":"devteds/noteflo-vscode-extension","owner":"devteds","description":"Professional workflow VS Code extension for consultants and freelancers: time tracking, notes, todos, and invoicing","archived":false,"fork":false,"pushed_at":"2025-07-30T13:51:00.000Z","size":1964,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-13T21:52:04.822Z","etag":null,"topics":["consulting","freelancer","invoicing","invoicing-application","notes","notes-app","pdf-generation","productivity","productivity-tools","time-tracking","typescript","vscode-extension","workflow"],"latest_commit_sha":null,"homepage":"https://github.com/devteds/noteflo-vscode-extension","language":"TypeScript","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/devteds.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-07-27T05:06:43.000Z","updated_at":"2025-07-30T13:51:04.000Z","dependencies_parsed_at":"2025-07-28T00:40:00.008Z","dependency_job_id":null,"html_url":"https://github.com/devteds/noteflo-vscode-extension","commit_stats":null,"previous_names":["devteds/noteflo-vscode-extension"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devteds/noteflo-vscode-extension","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devteds%2Fnoteflo-vscode-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devteds%2Fnoteflo-vscode-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devteds%2Fnoteflo-vscode-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devteds%2Fnoteflo-vscode-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devteds","download_url":"https://codeload.github.com/devteds/noteflo-vscode-extension/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devteds%2Fnoteflo-vscode-extension/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34925718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"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":["consulting","freelancer","invoicing","invoicing-application","notes","notes-app","pdf-generation","productivity","productivity-tools","time-tracking","typescript","vscode-extension","workflow"],"created_at":"2025-08-13T21:51:59.579Z","updated_at":"2026-06-29T11:31:40.115Z","avatar_url":"https://github.com/devteds.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NoteFlo - Professional Workflow Extension for VS Code\n\n**Professional workflow solution: time tracking, notes, todos, and invoicing for consultants and freelancers**\n\n[![VS Code](https://img.shields.io/badge/VS%20Code-1.60+-blue.svg)](https://code.visualstudio.com/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-4.9+-blue.svg)](https://www.typescriptlang.org/)\n[![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg)](https://nodejs.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/devteds.noteflo.svg?label=VS%20Code%20Marketplace\u0026color=blue)](https://marketplace.visualstudio.com/items?itemName=devteds.noteflo)\n[![Marketplace Downloads](https://img.shields.io/visual-studio-marketplace/d/devteds.noteflo.svg?color=blue)](https://marketplace.visualstudio.com/items?itemName=devteds.noteflo)\n[![Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/devteds.noteflo.svg?color=blue)](https://marketplace.visualstudio.com/items?itemName=devteds.noteflo)\n\n*Built by [Chandra Shettigar](https://github.com/shettigarc)*\n\n## 🎯 Overview\n\nNoteFlo is a VS Code extension designed for developers, tech consultants, freelancers, and tech professionals who need to seamlessly manage their workflow within their development environment. It combines time tracking, note-taking, todo management, and professional invoicing into a unified, efficient system.\n\nPerfect for developers, consultants, and freelancers who want to:\n\n\n## 🖼️ Screenshots\n\n\u003cdiv align=\"center\" style=\"display: flex; flex-wrap: wrap; gap: 12px; justify-content: center;\"\u003e\n  \u003cimg src=\"assets/screenshots/command-pallete.png\" alt=\"Command Palette\" width=\"320\" style=\"margin:8px; border-radius:8px; box-shadow:0 2px 8px #0002;\" /\u003e\n  \u003cimg src=\"assets/screenshots/meeting-note.png\" alt=\"Meeting Note\" width=\"320\" style=\"margin:8px; border-radius:8px; box-shadow:0 2px 8px #0002;\" /\u003e\n  \u003cimg src=\"assets/screenshots/sidepanel.png\" alt=\"Sidebar Panel\" width=\"320\" style=\"margin:8px; border-radius:8px; box-shadow:0 2px 8px #0002;\" /\u003e\n  \u003cimg src=\"assets/screenshots/explorer.png\" alt=\"Explorer Integration\" width=\"320\" style=\"margin:8px; border-radius:8px; box-shadow:0 2px 8px #0002;\" /\u003e\n  \u003cimg src=\"assets/screenshots/notes-dash.png\" alt=\"Notes Dashboard\" width=\"320\" style=\"margin:8px; border-radius:8px; box-shadow:0 2px 8px #0002;\" /\u003e\n  \u003cimg src=\"assets/screenshots/todos.png\" alt=\"Todo List\" width=\"320\" style=\"margin:8px; border-radius:8px; box-shadow:0 2px 8px #0002;\" /\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\u003ci\u003eNoteFlo in action: command palette, meeting notes, sidebar, explorer, notes dashboard, and todos.\u003c/i\u003e\u003c/p\u003e\n\n\n## 🌟 Key Features\n\n### ⏱️ **Smart Time Tracking**\n- **One-click start/stop** time tracking with descriptions\n- **Manual time entry** for offline work, meetings, and travel\n- **Real-time status bar** showing active timer and elapsed time\n- **Monthly file rotation** for organized time entry storage\n- **Timezone-aware** timestamps (configurable CST, EST, PST, etc.)\n\n### 📝 **Enhanced Note Management**\n- **Meeting notes** with structured templates, attendee tracking, and time integration\n- **Daily journals** for reflection and planning with focus areas\n- **General notes** with categorization and metadata\n- **Priority-based todos** with visual indicators (🔴 Urgent, 🟠 High, 🟡 Normal, 🟢 Low)\n- **Smart categorization**: General vs Project todos with automatic workspace detection\n- **Auto-generated notes index** organized by type and recency\n- **Dynamic dashboard** with analytics and quick access to recent items\n- **Foam-compatible** wiki-linking and graph visualization\n- **Git-friendly** filename conventions optimized for both readability and automation\n\n### 💰 **Professional Invoicing**\n- **Dual-format generation**: Markdown + PDF invoices\n- **Sequential invoice numbering** (INV-2025-001, INV-2025-002...)\n- **Comprehensive invoice details**: business info, client details, line items, tax calculations\n- **Multi-page PDF support** with automatic page breaks\n- **Configurable currency** and tax rates (default INR, supports any currency)\n- **Professional PDF layout** with proper spacing and formatting\n\n### 🎯 **Integrated Workflow**\n- **Sidebar integration** for quick access to all features\n- **Command palette** commands for keyboard-driven workflow\n- **Smart time tracking prompts** when creating meeting notes\n- **Dynamic dashboard** with real-time analytics and quick actions\n- **Auto-updating indexes** for seamless organization\n- **Cross-platform compatibility** with consistent behavior\n\n## 🚀 Installation\n\n### From VS Code Marketplace (Recommended)\n1. **Open VS Code**\n2. **Go to Extensions** (`Ctrl+Shift+X` / `Cmd+Shift+X`)\n3. **Search for \"NoteFlo\"** by Devteds\n4. **Click Install**\n5. **Open a workspace folder** (required for NoteFlo functionality)\n\n**Or install via Command Palette:**\n1. Open Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`)\n2. Type: `ext install devteds.noteflo`\n3. Press Enter\n\n**Or install via terminal:**\n```bash\ncode --install-extension devteds.noteflo\n```\n\n[**→ Install from VS Code Marketplace**](https://marketplace.visualstudio.com/items?itemName=devteds.noteflo)\n\n### From VSIX Package (Development)\n1. Download the latest `noteflo-1.x.y.vsix` file\n2. Open VS Code  \n3. Run: `code --install-extension noteflo-1.x.y.vsix`\n4. Reload VS Code window\n5. Open a workspace folder (required for NoteFlo functionality)\n\n### Initial Setup\n\n**Configuration is completely optional!** NoteFlo works out-of-the-box for note-taking and todos. Only configure if you need specific settings or invoicing features.\n\n1. Open Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`)\n2. Run **\"NoteFlo: Configure NoteFlo\"**\n3. Choose your use case:\n   - **Consulting/Freelancing**: Full setup with business info, client details, and billing (for invoicing)\n   - **Note-taking Only**: Just timezone configuration\n4. Follow the guided prompts based on your selection\n\n**Note**: All features work immediately without configuration. Business setup is only needed for professional invoicing.\n\n### Configuration File\nNoteFlo uses a single unified configuration file:\n\n**`.noteflo/config.json`** - All settings in one place (git-ignored)\n\n**For Note-taking Only:**\n```json\n{\n  \"directories\": {\n    \"meeting_notes\": \"docs/meeting-notes\",\n    \"daily_notes\": \"docs/daily-notes\", \n    \"general_notes\": \"docs/notes\",\n    \"dashboard\": \"docs/dashboard\"\n  },\n  \"files\": {\n    \"main_dashboard\": \"docs/index.md\"\n  },\n  \"settings\": {\n    \"auto_refresh_dashboard\": true,\n    \"default_note_template\": \"standard\",\n    \"timezone\": \"America/Chicago\"\n  }\n}\n```\n\n**For Consulting/Freelancing (includes everything above plus):**\n```json\n{\n  \"directories\": { \"...\": \"...\" },\n  \"files\": { \"...\": \"...\" },\n  \"settings\": { \"...\": \"...\" },\n  \"business\": {\n    \"name\": \"Your Business Name\",\n    \"address\": \"Your Address\",\n    \"email\": \"your@email.com\",\n    \"phone\": \"123-456-7890\",\n    \"website\": \"yourwebsite.com\"\n  },\n  \"client\": {\n    \"name\": \"Client Name\",\n    \"contact\": \"Client Contact Person\",\n    \"email\": \"client@email.com\"\n  },\n  \"billing\": {\n    \"hourlyRate\": 150,\n    \"currency\": \"USD\",\n    \"taxRate\": 0,\n    \"paymentInstructions\": \"Payment due within 30 days...\",\n    \"invoiceNotes\": \"Thank you for your business!\"\n  }\n}\n```\n\n**Configuration Levels:**\n- **No config**: Notes, todos, and basic time tracking work immediately\n- **Timezone only**: Better timestamp formatting for your location  \n- **Full consulting**: Professional invoicing with your business branding\n\n## 📖 Quick Start Guide\n\n### ⏱️ **Time Tracking**\n\n1. **Start Tracking**: Open Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) → `NoteFlo: Start Time Tracking`\n2. **Enter Description**: Describe what you're working on\n3. **Check Status**: Status bar shows active timer and elapsed time\n4. **Stop Tracking**: Command Palette → `NoteFlo: Stop Time Tracking`\n5. **Manual Entry**: Command Palette → `NoteFlo: Enter Time (Offline Work)` for manual time entries\n\n### 📝 **Note Creation**\n\n**Meeting Notes:**\n1. Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) → `NoteFlo: New Meeting Note`\n2. Enter meeting type, description, and attendees\n3. Get rich templates with agenda, notes, decisions, and action items\n4. Automatic time tracking integration\n\n**Daily Journals:**\n1. Command Palette → `NoteFlo: Create Daily Journal`\n2. Automatic date-based naming\n3. Structured templates with focus areas, accomplishments, and reflections\n4. Opens existing journal if already created for the day\n\n**General Notes:**\n1. Command Palette → `NoteFlo: Create New Note`\n2. Choose from categories: Development, Research, Ideas, Documentation, etc.\n3. Rich metadata and linking support\n\n**Priority-Based Todos:**\n1. Command Palette → `NoteFlo: Quick Todo`\n2. **Categories**: \n   - **General**: Personal tasks and reminders → `general-todos.md`\n   - **Project**: Current workspace tasks → `project-todos.md`\n3. **Priority Levels**:\n   - 🔴 **Urgent**: Needs immediate attention\n   - 🟠 **High**: Important and time-sensitive  \n   - 🟡 **Normal**: Regular priority\n   - 🟢 **Low**: Can be done when time permits\n4. Automatic organization by priority within each file\n\n### 💰 **Invoice Generation**\n\n1. **Generate Invoice**: Command Palette → `NoteFlo: Generate Invoice` and select date range\n2. **Choose Format**: Markdown and/or PDF generation\n3. **Professional Output**: Sequential numbering and comprehensive details\n4. **View History**: Command Palette → `NoteFlo: View Invoices` to browse past invoices\n\n## 🗂️ **File Organization**\n\nNoteFlo creates a clean, Git-friendly file structure:\n\n```\nyour-project/\n├── .noteflo/\n│   ├── config.json              # Your configuration (git-tracked)\n│   └── config.template.json     # Template file (git-tracked)\n└── docs/\n    ├── time-tracking/\n    │   ├── time_entries_2025-01.json  # Monthly time entries\n    │   └── active_session.json        # Current session (git-ignored)\n    ├── index.md                     # Dynamic dashboard (auto-generated)\n    ├── meeting-notes/               # Meeting notes (git-tracked)\n    │   └── client-discussion-2025-07-28.md\n    ├── daily-notes/                 # Daily journals (git-tracked)\n    │   └── 2025-07-28.md\n    ├── notes/                       # General notes (git-tracked)\n    │   ├── index.md                 # Auto-generated index\n    │   └── project-idea-2025-07-28.md\n    ├── project-planning/            # Todo management (git-tracked)\n    │   ├── general-todos.md         # Personal todos\n    │   └── project-todos.md         # Workspace-specific todos\n    ├── client-invoices/             # Generated invoices (git-tracked)\n    └── dashboard/                   # Dashboard components (auto-generated)\n```\n\n## 🎮 **Command Palette Reference**\n\nAccess all NoteFlo features through the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`):\n\n### **📝 Note Management**\n- `NoteFlo: New Meeting Note` - Create structured meeting note with templates\n- `NoteFlo: Create Daily Journal` - Create or open today's journal entry\n- `NoteFlo: Create New Note` - Create categorized general note\n- `NoteFlo: Quick Todo` - Add priority-based todo (General/Project categories)\n- `NoteFlo: Update Notes Index` - Refresh notes organization\n- `NoteFlo: Open Dashboard` - Access dynamic dashboard\n- `NoteFlo: Refresh Dashboard` - Update dashboard analytics\n\n### **⏱️ Time Tracking**\n- `NoteFlo: Start Time Tracking` - Begin tracking with description\n- `NoteFlo: Stop Time Tracking` - End current session\n- `NoteFlo: Time Status` - Show current tracking status\n- `NoteFlo: Enter Time (Offline Work)` - Manual time entry for offline work\n\n### **💰 Invoicing**\n- `NoteFlo: Generate Invoice` - Create professional invoices\n- `NoteFlo: View Invoices` - Browse invoice history\n\n### **⚙️ Configuration**\n- `NoteFlo: Configure NoteFlo` - Interactive setup wizard (for invoicing)\n- `NoteFlo: Edit Configuration` - Open config file for editing (if exists)\n- `NoteFlo: Test Configuration` - Validate current configuration\n\n**💡 Pro Tip**: Type \"NoteFlo\" in the Command Palette to see all available commands!\n\n## 📋 **Todo Management System**\n\nNoteFlo includes a sophisticated priority-based todo system designed for professional workflows:\n\n### **Categories**\n- **General Todos** (`general-todos.md`): Personal tasks, reminders, and non-project work\n- **Project Todos** (`project-todos.md`): Tasks specific to your current workspace\n\n### **Priority Levels**\nEach todo is assigned a visual priority level:\n\n- 🔴 **Urgent**: Critical issues requiring immediate attention\n- 🟠 **High**: Important tasks that are time-sensitive  \n- 🟡 **Normal**: Standard priority items for regular workflow\n- 🟢 **Low**: Tasks that can be completed when time permits\n\n### **File Structure**\n```markdown\n# Project Todo List\n\n## Active Tasks\n\n### Urgent Priority\n- [ ] **[Urgent]** 🔴 Fix critical production bug *(Added: July 28, 2025 at 10:30 AM)*\n\n### High Priority  \n- [ ] **[High]** 🟠 Complete client review by EOD *(Added: July 28, 2025 at 9:15 AM)*\n\n### Normal Priority\n- [ ] **[Normal]** 🟡 Update project documentation *(Added: July 28, 2025 at 8:45 AM)*\n\n### Low Priority\n- [ ] **[Low]** 🟢 Optimize build scripts *(Added: July 28, 2025 at 8:00 AM)*\n\n## Completed Tasks\n- [x] **[High]** 🟠 Deploy hotfix to staging *(Completed: July 27, 2025)*\n\n---\n*Priority levels: 🔴 Urgent | 🟠 High | 🟡 Normal | 🟢 Low*\n```\n\n### **Smart Organization**\n- Todos are automatically sorted by priority within each category\n- Timestamps include timezone-aware creation dates\n- Completed tasks can be moved to the \"Completed Tasks\" section\n- Dashboard integration shows todo counts and recent additions\n\n## ⚙️ **Configuration System**\n\nNoteFlo has **two optional configuration systems** depending on your needs:\n\n### **🎯 Quick Start (No Configuration)**\n- **Notes, todos, journals**: Work immediately without any setup\n- **Basic time tracking**: Start/stop tracking works out-of-the-box\n- **Default structure**: Uses sensible defaults for file organization\n\n### **💼 Business Configuration (For Consultants/Freelancers)**\n\n**When you need it**: Time tracking with invoicing, professional billing\n**Setup**: Run `NoteFlo: Configure NoteFlo`\n**File**: `.noteflo/config.json` (git-ignored)\n\n```json\n{\n  \"business\": {\n    \"name\": \"Your Consulting Business\",\n    \"address\": \"123 Business St, City, State 12345\",\n    \"email\": \"your@business.com\",\n    \"phone\": \"555-123-4567\",\n    \"website\": \"www.yourbusiness.com\"\n  },\n  \"client\": {\n    \"name\": \"Client Company Name\",\n    \"contact\": \"Client Contact Person\",\n    \"address\": \"Client Address\",\n    \"email\": \"client@company.com\"\n  },\n  \"billing\": {\n    \"hourlyRate\": 150,\n    \"currency\": \"USD\",\n    \"taxRate\": 0,\n    \"paymentInstructions\": \"Payment due within 30 days. Wire transfer details included.\",\n    \"invoiceNotes\": \"Thank you for your business!\"\n  },\n  \"preferences\": {\n    \"timezone\": \"America/New_York\"\n  }\n}\n```\n\n### **📁 Directory Configuration (Optional Customization)**\n\n**When you need it**: Custom file organization, team consistency\n**Setup**: Manual creation or future config command\n**File**: `.noteflo/config.json` (optional)\n\n```json\n{\n  \"directories\": {\n    \"meeting_notes\": \"meetings\",\n    \"daily_notes\": \"journals\",\n    \"general_notes\": \"notes\",\n    \"dashboard\": \"dashboard\"\n  },\n  \"files\": {\n    \"main_dashboard\": \"overview.md\"\n  },\n  \"settings\": {\n    \"auto_refresh_dashboard\": true,\n    \"default_note_template\": \"detailed\",\n    \"timezone\": \"America/Chicago\"\n  }\n}\n```\n\n### **Configuration Usage Patterns**\n\n**📝 Notes \u0026 Todos Only**\n- No configuration needed\n- Uses default directory structure\n- All note features work immediately\n\n**⏱️ Time Tracking Only** \n- No configuration needed for basic tracking\n- Manual time entries and status work\n- No invoicing capabilities\n\n**💰 Professional Consulting**\n- Business configuration required\n- Enables invoice generation\n- Professional PDF output with your branding\n- Client billing and time tracking integration\n\n### **Configuration Commands**\n- **Create Business Config**: `NoteFlo: Configure NoteFlo` - Sets up invoicing\n- **Edit Configuration**: `NoteFlo: Edit Configuration` - Opens config file (if exists)\n- **Test Configuration**: `NoteFlo: Test Configuration` - Validates current settings\n\n## 🌐 **Timezone Support**\n\nNoteFlo supports configurable timezones for global teams:\n\n- **Configurable during setup**: America/Chicago, America/New_York, Europe/London, etc.\n- **All timestamps use your business timezone**\n- **Timezone validation** with helpful error messages\n- **Multiple date formats** for different contexts\n\n## 📊 **Dynamic Dashboard**\n\nThe NoteFlo dashboard provides a real-time overview of your workspace activity:\n\n### **Features**\n- **Recent Activity**: Latest meeting notes, journal entries, and general notes\n- **Todo Analytics**: Count by priority level and category\n- **Time Tracking Summary**: Current session status and recent entries\n- **Quick Actions**: Fast access to common commands\n- **File Statistics**: Overview of workspace documentation\n\n### **Auto-Updates**\n- Refreshes automatically when you create new content\n- Smart caching prevents unnecessary regeneration\n- Manual refresh available via `Cmd+K R`\n\n### **Dashboard Structure**\n```markdown\n# NoteFlo Dashboard - Project Name\n\n*Last updated: July 28, 2025 at 2:30 PM (America/Chicago)*\n\n## 📊 Quick Stats\n- **Active Todos**: 12 (🔴 2 urgent, 🟠 4 high, 🟡 5 normal, 🟢 1 low)\n- **This Week**: 3 meetings, 5 journal entries, 8 notes\n- **Time Tracking**: Currently active (2h 15m elapsed)\n\n## 🎯 Quick Actions\n- [Create Meeting Note](command:noteflo.newMeetingNote)\n- [Quick Todo](command:noteflo.quickTodo)  \n- [Start Time Tracking](command:noteflo.startTimeTracking)\n- [Generate Invoice](command:noteflo.generateInvoice)\n\n## 📝 Recent Activity\n\n### Meeting Notes (Last 5)\n- [Client Review - July 28](docs/meeting-notes/client-review-2025-07-28.md)\n- [Sprint Planning - July 27](docs/meeting-notes/sprint-planning-2025-07-27.md)\n\n### Daily Journals (Last 5)  \n- [July 28, 2025](docs/daily-notes/2025-07-28.md)\n- [July 27, 2025](docs/daily-notes/2025-07-27.md)\n\n### General Notes (Last 5)\n- [API Design Ideas - July 28](docs/notes/api-design-ideas-2025-07-28.md)\n\n---\n*Dashboard auto-updates when you create new content*\n```\n\n## 💼 **Perfect For**\n\n- **Consultants**: Track client work and generate professional invoices\n- **Freelancers**: Manage multiple projects with organized time tracking\n- **Developers**: Document meetings and track feature development time\n- **Project Managers**: Maintain organized notes and todo lists\n- **Remote Workers**: Keep structured records of daily activities\n\n## 🛠️ **System Requirements**\n\n- **VS Code**: 1.60+ \n- **Node.js**: 20+ (for development)\n- **Operating System**: Windows, macOS, Linux\n- **Workspace**: Requires an open folder/workspace for functionality\n\n## 📋 **Feature Overview**\n\n### **📝 Core Features**\n- **Meeting Notes**: Structured templates with attendee tracking and time integration\n- **Daily Journals**: Reflection and planning with focus areas and accomplishments  \n- **General Notes**: Categorized notes with rich metadata and linking\n- **Priority Todos**: Visual priority system (🔴🟠🟡🟢) with General/Project categories\n- **Dynamic Dashboard**: Real-time analytics and quick access to recent activity\n\n### **⏱️ Time Management**\n- **Smart Tracking**: One-click start/stop with description prompts\n- **Manual Entries**: Offline work, meetings, and travel time logging\n- **Status Integration**: Real-time timer in VS Code status bar\n- **Monthly Organization**: Automatic file rotation for organized storage\n\n### **💰 Professional Invoicing** (Optional - requires configuration)\n- **Dual Format**: Generate both Markdown and PDF invoices\n- **Professional Layout**: Sequential numbering and comprehensive billing details\n- **Business Branding**: Include your business info, logo, and custom payment terms\n- **Time Integration**: Automatic calculation from tracked hours\n\n### **🔧 Workspace Integration**\n- **Command Palette**: Access all features through VS Code's command system\n- **Sidebar Panel**: Quick overview and actions in the Explorer\n- **File Organization**: Git-friendly structure with sensible defaults\n- **Cross-Platform**: Consistent behavior on Windows, macOS, and Linux\n\n## 🔧 **Troubleshooting**\n\n### **Common Issues**\n\n**Commands not found**: Ensure you have a workspace folder open. NoteFlo requires an active workspace.\n\n**Sidebar shows \"no data provider\"**: Restart VS Code or run \"Developer: Reload Window\"\n\n**Time tracking not working**: Check that you have proper file permissions in the workspace directory.\n\n**PDF generation fails**: Ensure you have sufficient disk space and write permissions.\n\n**Configuration not loading**: \n- For business config: Check that `.noteflo/config.json` exists and has valid JSON syntax\n- For invoicing issues: Run \"Configure NoteFlo\" to set up business information\n- For directory issues: NoteFlo uses sensible defaults if no directory config exists\n\n**Invoice generation fails**: \n- Ensure business configuration is complete (run \"Configure NoteFlo\")\n- Check that business name, email, client name, and hourly rate are set\n- Verify timezone setting is valid (e.g., \"America/Chicago\")\n\n**Dashboard not updating**: Try \"Refresh Dashboard\" command or check if auto-refresh is enabled in settings.\n\n**Todos not organized properly**: Ensure you're using the latest version and that priority levels are being selected during creation.\n\n**Notes and todos work but invoicing doesn't**: Business configuration is required for invoicing. Run \"NoteFlo: Configure NoteFlo\" to set up billing information.\n\n### **Performance Tips**\n\n- **Large workspaces**: NoteFlo indexes files efficiently, but very large note collections may slow dashboard updates\n- **Git integration**: Use `.gitignore` entries for private configuration files (automatically handled)\n- **File organization**: Keep notes in recommended directory structure for best performance\n- **Regular cleanup**: Archive old completed todos and outdated notes periodically\n\n### **Configuration Validation**\n\n**For Business Configuration:**\nUse `NoteFlo: Test Configuration` to check:\n- Business information is complete\n- Client details are valid\n- Billing rates and currency are set\n- Timezone format is correct (e.g., \"America/Chicago\")\n\n**For Directory Configuration:**\n- Directory paths are valid and writable\n- File paths are accessible\n- JSON syntax is valid\n- Default fallbacks work if config is missing\n\n**No Configuration Needed:**\n- Notes, todos, and journals work immediately\n- Time tracking (start/stop) works without setup\n- Dashboard updates automatically\n\n### **Getting Help**\n\n- Check the [DEVELOPMENT.md](DEVELOPMENT.md) for technical details\n- Review the [CHANGELOG.md](CHANGELOG.md) for recent updates\n- Open an issue for bugs or feature requests\n\n## 📄 **License**\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 👨‍💻 **Author \u0026 Organization**\n\n**Created by**: [Chandra Shettigar](https://github.com/shettigarc)  \n**Organization**: [Devteds](https://github.com/devteds)  \n**Website**: [devteds.com](https://www.devteds.com)  \n**Contact**: [chandra@devteds.com](mailto:chandra@devteds.com)\n\n*Chandra is a Senior Software Engineer working across multiple technologies and programming languages, with a current focus on AI exploration and innovation.*\n\n## 🎓 **Learn More**\n\nInterested in DevOps, Platform Engineering, and Cloud technologies? Check out:\n\n- **Courses**: [devteds.com](https://www.devteds.com)\n- **YouTube**: [Chandra Shettigar](https://www.youtube.com/c/ChandraShettigar)\n- **Blog**: [devteds.com](https://www.devteds.com)\n- **LinkedIn**: [shettigarc](https://linkedin.com/in/shettigarc)\n\n---\n\n**NoteFlo** - Professional workflow made simple. Built for developers, by developers. 🚀","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevteds%2Fnoteflo-vscode-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevteds%2Fnoteflo-vscode-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevteds%2Fnoteflo-vscode-extension/lists"}