Text Expander By Ofi Khan

About

A powerful and lightweight Chrome extension designed to streamline text expansion across all websites. Perfect for customer support, developers, writers, and anyone who wants to eliminate repetitive typing. This tool allows you to create, manage, export, and import shortcuts with advanced features like variable support, usage statistics, and universal compatibility.

✨ Key Features

🚀 Universal Compatibility
- Works on ALL websites - Gmail, WhatsApp Web, social media, and more
- Smart input detection - Supports regular text fields, rich text editors, and contenteditable elements
- Real-time expansion - Text expands as you type or when you press space/tab/enter

📝 Advanced Shortcut Management
- Add and Delete Shortcuts: Create custom shortcuts (e.g., `asap` → "As Soon As Possible")
- Edit Shortcuts: Modify existing shortcuts including shortcut key, expanded text, and category
- Default shortcuts included: Ready-to-use examples (`/ty`, `brb`, `omw`, `lmk`, `sig`)
- Case sensitivity options: Choose between case-sensitive or case-insensitive matching
- Smart expansion: Expands on space, tab, or enter key press
- Scrollable shortcut list: Organized display with smooth scrolling for large collections
- Duplicate detection: Warns when adding existing shortcuts with replace option
- Bulk deletion: Delete all shortcuts at once with confirmation dialog
- Search Option: Quickly find shortcuts in large lists with real-time search
- Icon-based interface: Modern edit and delete icons for cleaner UI

📁 Category Management
- Organize shortcuts: Create custom categories to organize your shortcuts
- Color-coded categories: Assign colors to categories for visual identification
- Filter by category: Quickly filter shortcuts by category with shortcut counts
- Category badges: Visual indicators showing which category each shortcut belongs to
- Edit categories: Modify category names and colors without losing shortcuts
- Default categories: Pre-configured General, Work, and Personal categories
- Uncategorized tracking: Automatically tracks shortcuts without categories

🔧 Enhanced Variables System
Support for dynamic content insertion with cursor positioning:
- `{date}` - Current date (e.g., 31/07/2025)
- `{time}` - Current time (e.g., 2:30:45 PM)
- `{datetime}` - Full date and time
- `{year}` - Current year (e.g., 2025)
- `{month}` - Current month (e.g., 07)
- `{day}` - Current day (e.g., 31)
- `{timestamp}` - Unix timestamp
- `{cursor}` - Advanced cursor positioning after expansion

📊 Comprehensive Usage Statistics
- Track expansion usage - See which shortcuts you use most frequently
- Top 10 most used shortcuts - Ranked list with usage counts
- Detailed statistics dashboard - Total expansions, most popular shortcuts
- Performance insights - Understand your typing patterns and productivity gains
- Usage summary - Complete overview of shortcut performance
- Auto-sync statistics - Statistics update immediately when shortcuts are modified

🎛️ Enhanced Settings & Controls
- Enable/Disable toggle - Turn the extension on/off without uninstalling
- Case sensitivity control - Match shortcuts exactly or ignore case
- Visual status indicators - Clear indication of extension status with improved positioning
- Real-time settings sync - Changes apply immediately across all tabs
- Clean tabbed interface - Streamlined navigation without redundant titles

💾 Complete Data Management
- Enhanced Export/Import - Backup shortcuts, settings, and statistics in JSON format
- Complete data backup - Never lose your configurations, includes version info
- Easy migration - Transfer settings between devices/browsers seamlessly
- Clear statistics option - Reset usage data when needed
- Data validation - Import validation with detailed feedback
- Bulk operations - Delete all shortcuts with confirmation for quick reset

⌨️ Keyboard Integration & Accessibility
- Popup shortcut: `Ctrl+Shift+O` (Windows/Linux) or `Cmd+Shift+O` (Mac)
- Right-click access - Context menu in text fields and on selected text
- Context menu options: "Open Text Expander" and "Add New Shortcut"
- Keyboard navigation - Tab through interface elements
- Search shortcuts - Use Escape key to clear search and exit
- Shortcut key warnings - Alerts if keyboard shortcuts aren't configured

🎨 Modern User Interface
- Consistent design system - Universal borders, colors, and typography
- Optimized layout - Full-width flex layouts for better space utilization
- Visual feedback - Success confirmations and status indicators
- Color-coded elements - Professional green theme throughout
- Search functionality - Real-time filtering with highlighted results
- Responsive design - Clean, modern interface that's easy to navigate
- Custom scrollbars - Consistent styling throughout the interface
- Improved accessibility - Better focus states and keyboard navigation
- Icon-based actions - Modern edit (pencil) and delete (trash) icons
- Category badges - Color-coded visual indicators for shortcuts
- Tabbed interface - Organized tabs for Shortcuts, Categories, Settings, and Stats

🚀 Usage Guide

Getting Started
1. Open the extension by clicking the icon or using `Ctrl+Shift+O`
2. Try default shortcuts: Type `brb` and press space - it expands to "Be right back"
3. Explore other defaults: `omw`, `lmk`, `sig`
4. Check the status indicator: Green dot means extension is active

Adding Custom Shortcuts

Method 1: Manual Entry
1. Navigate to Shortcuts tab in the popup
2. Enter shortcut (e.g., `addr`) and expanded text (e.g., your address)
3. Use variables for dynamic content: `Hello! Today is {date}`
4. Position cursor with `{cursor}` variable for precise placement
5. Click "Add Shortcut" to save with visual confirmation

Method 2: From Selected Text (NEW!)
1. Select any text on any webpage
2. Right-click and choose "Add New Shortcut"
3. Extension opens with selected text in expanded field
4. Type shortcut key (e.g., `addr`) - cursor is ready
5. Select category (optional)
6. Click "Add Shortcut" to save

Editing Shortcuts
1. Click the edit icon (pencil) next to any shortcut
2. Modify the shortcut key, expanded text, or category
3. Click "Update Shortcut" to save changes
4. Click "Cancel" to exit without saving

Managing Categories
1. Navigate to Categories tab in the popup
2. Create categories with custom names and colors
3. Edit categories by clicking the edit icon (pencil)
4. Delete categories by clicking the delete icon (trash)
5. Filter shortcuts by category using the dropdown in Shortcuts tab

Searching & Managing Shortcuts

1. Use the search box at the top of the Shortcuts tab 
2. Type to filter shortcuts by name or expanded text
3. Clear search using the X button or Escape key
4. View results count to see how many shortcuts match your query
5. Delete individual shortcuts with red delete buttons
6. Delete all shortcuts using the "Delete All" button (requires confirmation)

Using Advanced Variables
Create dynamic shortcuts with variables and cursor positioning:
```
Shortcut: meeting
Expanded: Hi team, let's meet on {date} at {time}. {cursor}
Result: Hi team, let's meet on 31/07/2025 at 2:30:45 PM. [cursor here]
```
```
Shortcut: sig
Expanded: Best regards,\n{cursor}\n{date}
Result: Best regards,
[cursor here]
31/07/2025
```

Advanced Features
- Categories Tab: Organize shortcuts into color-coded categories
- Settings Tab: Configure case sensitivity and enable/disable
- Statistics Tab: View usage patterns and most-used shortcuts
- Export/Import: Backup your complete configuration
- Search Feature: Quickly find shortcuts in large collections with real-time search
- Filter by Category: View shortcuts by category with shortcut counts

Site-Specific Behavior
The extension intelligently adapts to different websites:
- Gmail: Works in compose windows and replies
- WhatsApp Web: Expands in chat input
- Social Media: Compatible with Facebook, X, LinkedIn, etc.

📞 Support & Community
- GitHub Issues: [Report bugs or request features](https://github.com/ofikhan/text-expander-by-ofi-khan/issues)
- Email Support: [Contact developer](mailto:[email protected])
- Developer Website: [Ofi Khan](https://www.ofikhan.com)
- Chrome Web Store: [Leave reviews and ratings](https://chromewebstore.google.com/detail/text-expander-by-ofi-khan/ofdlmmadalaoceafcekkkanigmdehbig)

💡 Tips & Best Practices
1. Use descriptive shortcuts: Create shortcuts that are easy to remember (e.g., addr for address)
2. Use context menu: Select text on any webpage and right-click "Add New Shortcut" for quick creation
3. Organize with categories: Group related shortcuts together (e.g., Work, Personal, Code)
4. Use color coding: Assign meaningful colors to categories for quick visual identification
5. Leverage variables: Use variables for dynamic content like dates and time
6. Use the search feature: Quickly find shortcuts in large collections using the search box
7. Filter by category: Use category filter to focus on specific shortcut groups
8. Regular backups: Use the export feature to create regular backups of your shortcuts and categories
9. Monitor statistics: Keep an eye on your most-used shortcuts using the statistics tab
10. Edit instead of delete: Use edit feature to modify shortcuts and preserve statistics
11. Delete unused shortcuts: Regularly clean up your list by deleting unused shortcuts

📄 License
This project is open-source and available under the MIT License.

🙏 Acknowledgements
- Built by: [Ofi Khan](https://www.ofikhan.com) 
- Inspired by: The need for efficient text expansion in customer support workflows and daily productivity
- Special thanks: To the community for feature requests, bug reports, and valuable feedback
- Design inspiration: Modern Chrome extension best practices and user experience guidelines

⭐ If you find this extension helpful, then please consider:
- Leaving a positive review on the Chrome Web Store
- Sharing with colleagues and friends

Made with ❤️ for productivity enthusiasts worldwide!