{"id":35166018,"url":"https://github.com/matrixrex/list-dock","last_synced_at":"2026-06-15T03:00:47.728Z","repository":{"id":330807589,"uuid":"1124015178","full_name":"MatrixRex/List-Dock","owner":"MatrixRex","description":"A sleek beautiful Chrome Extension for managing your tasks directly in the side panel","archived":false,"fork":false,"pushed_at":"2026-06-12T16:47:51.000Z","size":8763,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T18:16:45.187Z","etag":null,"topics":["browser-extension","chrome-extension","dark-mode","framer-motion","modern-ui","offline","productivity","react","side-panel","sidebar","tailwindcss-v4","task-manager","todo-list","typescript","vite","zustand"],"latest_commit_sha":null,"homepage":"","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/MatrixRex.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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-28T06:11:06.000Z","updated_at":"2026-06-12T16:47:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"81659f04-2a8e-47ce-af46-f418ccaab38b","html_url":"https://github.com/MatrixRex/List-Dock","commit_stats":null,"previous_names":["matrixrex/list-dock"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/MatrixRex/List-Dock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixRex%2FList-Dock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixRex%2FList-Dock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixRex%2FList-Dock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixRex%2FList-Dock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MatrixRex","download_url":"https://codeload.github.com/MatrixRex/List-Dock/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatrixRex%2FList-Dock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34345578,"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-15T02:00:07.085Z","response_time":63,"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":["browser-extension","chrome-extension","dark-mode","framer-motion","modern-ui","offline","productivity","react","side-panel","sidebar","tailwindcss-v4","task-manager","todo-list","typescript","vite","zustand"],"created_at":"2025-12-28T19:33:01.724Z","updated_at":"2026-06-15T03:00:47.687Z","avatar_url":"https://github.com/MatrixRex.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# List Dock 📋\n\nA sleek, high-performance Chrome Extension for managing your tasks directly in the side panel. Built with a focus on speed, premium aesthetics, and a seamless user experience.\n\n[![Latest Release](https://img.shields.io/github/v/release/MatrixRex/List-Dock?label=Download\u0026color=2e7d32\u0026logo=github)](https://github.com/MatrixRex/List-Dock/releases/latest)\n![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/Matrixrex/List-Dock/total)\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/shorts/MdnGKwZ9yDM\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\n    \u003cimg src=\"https://img.youtube.com/vi/MdnGKwZ9yDM/maxresdefault.jpg\"\n         alt=\"Demo video\"\n         width=\"720\"\u003e\n  \u003c/a\u003e\n  \u003cp align=\"center\"\u003e\n  ▶ Click to watch the demo (YouTube)\n\u003c/p\u003e\n\u003c/p\u003e\n\n\n## ✨ Key Features\n\n### ✅ Task Features\n- **Smooth Management**: Add, edit, delete tasks.\n- **Drag \u0026 Drop**: Rerrange tasks using drag \u0026 drop, and move them to folder.\n- **Deep Nesting**: Create subtasks within any task to break down complex projects.\n- **Multi-Select Drag \u0026 Drop**: Select multiple tasks using `Ctrl/Cmd + Click` and move/delete them as a group.\n- **Smart Sorting**: Active, uncompleted tasks are automatically pinned to the top for better focus.\n- **Context Actions**: Convert a task (with its subtasks) into a full folder directly from the context menu.\n\n### 📂 Folder Features\n- **Grid Layout**: View and organize your major categories in a clean, visual grid.\n- **Drag \u0026 Drop**: Reorder your folders within the root view to prioritize your workflows.\n- **Isolated Views**: Dive into a folder to focus solely on its tasks and subtasks.\n- **Local Search**: Fast, specific search that filters only within the current folder.\n- **Customization**: Adjust folder colors and icons to match your preferences.\n\n### ⌨️ Combo Input Features\n- **All-in-One Field**: A single, context-aware input area for all your creation commands.\n- **Task Mode**: Default mode to create new tasks.\n- **Subtask Mode**: When a task is selected, the input automatically switches to \"Subtask\" mode.\n- **Folder Mode**: Toggle the folder icon to create new high-level categories.\n- **Global Search**: When in root view, search across your entire workspace (including nested tasks) with real-time results.\n- **Folder Search**: When in a folder view, search only within the current folder.\n\n### 🛠️ Other Features\n- **10-Step Undo Stack**: A persistent history of your recent actions to easily recover from mistakes.\n- **Global Shortcuts**: Copy, paste, undo shortcuts support.\n- **Glassmorphism UI**: High-fidelity sci-fi design.\n- **Fluid Animations**: Smooth transitions and vertical expansions powered by Framer Motion.\n- **Local-First**: All data is stored securely on your machine via `chrome.storage.local`.\n\n---\n\n## 📦 Installation\n\nTo install List Dock in your browser:\n\n1. **Download the Latest Release**: Head to the [Latest Release](https://github.com/MatrixRex/List-Dock/releases/latest) page and download the `list-dock.zip` file.\n2. **Unzip the file**: Extract the contents to a folder on your computer.\n3. **Load in Chrome**:\n   - Open Chrome and navigate to `chrome://extensions/`.\n   - Enable **Developer mode** (top right toggle).\n   - Click **Load unpacked**.\n   - Select the folder you extracted in step 2.\n   - **Do not delete** the folder after loading.\n\n---\n\n## 📖 How to Use\n\n- **Toggle Sidebar**: Click the List Dock icon ![alt text](public/icons/icon16.png) in your browser toolbar.\n- **Bulk Actions**: Select multiple items with `Ctrl` and drag them to reparent or reorganize.\n- **Accidental Deletions**: Hit `Ctrl + Z` or use the toast notification undo button.\n- **Clear Selection**: Click any empty area to deselect the current task/folder.\n- **Smart Paste**: Copy any list from a text editor and paste (`Ctrl + V`) directly into the sidebar to auto-generate tasks and subtasks.\n\n---\n\n## ⌨️ Keyboard Shortcuts\n\n| Shortcut | Action | Description |\n| :--- | :--- | :--- |\n| `Ctrl + Z` | **Undo** | Recover deleted items or revert your last action (up to 10 steps). |\n| `Ctrl + C` | **Copy** | Copies selected task names. If enabled in settings, includes all subtasks in a formatted list. |\n| `Ctrl + V` | **Smart Paste** | Paste text to auto-generate tasks. Supports markdown, bullets, and indentation for subtasks. |\n| `Ctrl + Click` | **Multi-Select** | Select multiple tasks or folders for bulk moving or deletion. |\n| `Shift + Click` | **Range Select** | Select a range of tasks between the last selection and the current click. |\n| `Esc` | **Deselect** | Clear all current selections. |\n\n---\n\n## 🛠️ Tech Stack\n\n- **Core**: React 19, TypeScript\n- **Build**: Vite + CRXJS\n- **State**: Zustand\n- **Styling**: Tailwind CSS 4\n- **Animations**: Framer Motion\n- **Icons**: Lucide React\n- **Search**: Fuse.js\n- **Toasts**: React Hot Toast\n\n---\n\n## 🛠️ Local Development\n\nFollow these steps to set up the project locally for development:\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/MatrixRex/List-Dock.git\n   cd List-Dock\n   ```\n2. **Install Dependencies**:\n   ```bash\n   pnpm install\n   ```\n3. **Run Development Server**:\n   ```bash\n   pnpm dev\n   ```\n\n   This will generate a `dist` folder.\n5. **Load in Chrome**:\n   Follow the [Installation](#-installation) steps but select the `dist` folder instead of an unzipped release.\n\n## 🏷️ Release \u0026 Versioning\n\nThe project includes an automated release system that handles versioning and creates GitHub releases with the compiled extension.\n\n### 1. Versioning Wizard\nTo start a new release, run the following command and follow the interactive prompts:\n```bash\npnpm release\n```\nThis wizard will:\n- Update the version in `package.json` and `manifest.json`.\n- Create a new git tag formatted as `vX.X.X`.\n- Push the changes and the tag to your GitHub repository.\n\n### 2. Automated GitHub Workflow\nOnce a tag following the `v*` pattern (e.g., `v1.4.0`) is pushed, a GitHub Action (`.github/workflows/release.yml`) is automatically triggered. This workflow:\n- Installs dependencies and runs the production build.\n- Packages the `dist` directory into a `list-dock.zip` file.\n- Creates a new GitHub Release with the zip file attached and auto-generated changelogs.\n\n### ⚙️ Setup for Forked Repositories\nIf you have forked this repository and want to use the automated release system for your own versions:\n\n1. **Enable Actions**: Go to the **Actions** tab of your forked repository and click the button to enable workflows.\n2. **Configure Permissions**: \n   - Navigate to `Settings \u003e Actions \u003e General`.\n   - Scroll down to **Workflow permissions**.\n   - Select **Read and write permissions**. This is required for the action to create the release and upload the asset.\n   - Check **Allow GitHub Actions to create and approve pull requests** (optional but recommended).\n3. **Verify Tags**: Ensure your tag pushes include the `v` prefix to match the workflow trigger pattern.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! If you have a feature request, bug report, or want to contribute code:\n\n1. **Fork the Repository**.\n2. **Create a Feature Branch** (`git checkout -b feature/AmazingFeature`).\n3. **Commit Your Changes** (`git commit -m 'Add some AmazingFeature'`).\n4. **Push to the Branch** (`git push origin feature/AmazingFeature`).\n5. **Open a Pull Request**.\n\nPlease ensure your code follows the existing style and includes proper documentation for new features.\n\n\n\n## 📄 License\n\nThis project is **Open Source** and available under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixrex%2Flist-dock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatrixrex%2Flist-dock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatrixrex%2Flist-dock/lists"}