{"id":23228974,"url":"https://github.com/mrwweb/plans-editor-toolbar","last_synced_at":"2025-08-20T18:58:33.538Z","repository":{"id":219538407,"uuid":"749289615","full_name":"mrwweb/plans-editor-toolbar","owner":"mrwweb","description":"Adds formatting and shortcut buttons and shortcuts to the GrinnellPlans editor. Also transforms the editor on mobile for easier editing.","archived":false,"fork":false,"pushed_at":"2025-06-16T21:11:11.000Z","size":124,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-19T13:26:06.737Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrwweb.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2024-01-28T05:54:15.000Z","updated_at":"2025-06-16T21:11:15.000Z","dependencies_parsed_at":"2024-01-28T07:23:37.128Z","dependency_job_id":"b27647ec-f23d-46c6-9718-ab84a169b4f6","html_url":"https://github.com/mrwweb/plans-editor-toolbar","commit_stats":null,"previous_names":["mrwweb/plans-editor-toolbar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mrwweb/plans-editor-toolbar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwweb%2Fplans-editor-toolbar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwweb%2Fplans-editor-toolbar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwweb%2Fplans-editor-toolbar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwweb%2Fplans-editor-toolbar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrwweb","download_url":"https://codeload.github.com/mrwweb/plans-editor-toolbar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrwweb%2Fplans-editor-toolbar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271369235,"owners_count":24747793,"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-08-20T02:00:09.606Z","response_time":69,"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":[],"created_at":"2024-12-19T01:15:47.195Z","updated_at":"2025-08-20T18:58:33.465Z","avatar_url":"https://github.com/mrwweb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plans Editor Toolbar\n\nv1.7.1 ([Changelog](#changelog))\n\nMake [GrinnellPlans](https://grinnellplans.com) a little easier to use with a simple toolbar for formatting text, especially on phones or if you don't like HTML.\n\n![The plans editor toolbar sitting above the top of my plan](https://github.com/mrwweb/plans-editor-toolbar/blob/main/editor-screenshot.png?raw=true)\n\n## Features\n\nThis script adds a toolbar with the following features:\n\n- Buttons! Bold, italic, link, planlove brackets, date, horizontal rule, and editor help\n    - Buttons work to insert formatting or apply to selected text (especially helpful for links!)\n- [Keyboard shortcuts](#shortcuts) for every button function + `CTRL`/`CMD` + `s` to save your plan\n- 🪄 [Magic link pasting](#-magic-link-pasting-) 🪄\n- Full screen editor on mobile for _astoundingly_ better usability on your phone\n\n### 🪄 Magic link pasting 🪄\n\nLink pasting feels like magic if you've never used it before. To make a link with link pasting:\n\n1. Copy a URL to your clipboard\n2. Select the text that should be the link\n3. Paste (\\*right click\\* \u003e \"Paste\" or `CTRL`/`CMD` + `v`)\n4. Result `[{clipboard link}|{selected text}]`\n\n### Shortcuts\n\nWhen your cursor is in the plan editor, you can use the following shortcuts:\n\n| Shortcut      | Action                |\n|-------------- |---------------------- |\n| `Ctrl` + `b`  | Bold                  |\n| `Ctrl` + `i`  | Italic                |\n| `Ctrl` + `k`  | Make/Insert link      |\n| `Ctrl` + `l`  | Make/Insert planlove  |\n| `Ctrl` + `d`  | Insert `[date]`       |\n| `Ctrl` + `h`  | Insert `\u003chr\u003e`         |\n| `Ctrl` + `s`  | Save plan             |\n\n## Installation\n\nThe editor feature is installed as a custom UserScript, just like [NewLove](https://github.com/grinnellplans/Newlove) and [PlansPlus](https://github.com/niqjohnson/PlansPlus).\n\n### Step 1: Install a userscript browser add-on\n\nAll browsers can use the Tampermonkey browser extension, a cross-browser successor to Greasemonkey. Firefox users can also use [Greasemonkey](https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/). Both are available as add-ons for browsers on Android phones as well.\n\n- [Firefox Tampermonkey](https://addons.mozilla.org/en-US/firefox/addon/tampermonkey/)\n- [Chrome Tampermonkey](https://chromewebstore.google.com/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)\n- [Edge Tampermonkey](https://microsoftedge.microsoft.com/addons/detail/tampermonkey/iikmkjmpaadaobahmlepeloendndfphd)\n- [Safari Tampermonkey](https://apps.apple.com/us/app/tampermonkey/id1482490089)\n- [iOS Userscripts app for Safari on iPhone and iPad](https://apps.apple.com/us/app/userscripts/id1463298887)\n\n### Step 2: Open the userscript file to install it\n\n[Open the toolbar script.](https://github.com/mrwweb/plans-editor-toolbar/raw/main/plans-editor-toolbar.user.js) A box should show up asking you if you want to install the script.\n\n## Upgrading\n\nTampermonkey is known to stuggle with updates. You can always manually upgrade a script by [opening the toolbar script again](https://github.com/mrwweb/plans-editor-toolbar/raw/main/plans-editor-toolbar.user.js).\n\n## Known Issues and Limitations\n\n- It might be cool if the link button acted a little more like a builder/prompt to help people remember the format. Again, wouldn't be that hard to add if people want it. See: #2\n- Undo / Redo doesn't work for toolbar actions. It could be added if enough people run into problems. See: #4\n\n## Changelog\n\n### v1.7.1 (March 21, 2024)\n\n- Fix: Positioning of help dialog and a bit of help formatting improvements\n- Fix: Clicking submit button when editor was fullscreen didn't save plan\n\n### v1.7.0 (March 17, 2024)\n\n- Prevent plan loss! Warn you before closing the browser tab if you unsaved changes to your plan.\n- Add new help button with popup documentation for all features of the editor\n\n### v1.6.1 (March 8, 2024)\n\n- Fix shortcuts so browser doesn't respond to them.\n\n### v1.6.0 (March 3, 2024)\n\n- [Magic link pasting!](#-magic-link-pasting-)\n- [Shortcuts](#shortcuts) for `[date]` and `\u003chr\u003e`\n- Add new `@match` userscript rule so this works regardless of `www` in URL.\n- Refactor code into more reusable functions and remove some unnecessary checks and `preventDefault()`s. Encapsulate code in function to avoid interferance with other scripts.\n\n### v1.5.0 (February 28, 2024)\n\n- New Editor fullscreen mode when editing on phones! (Added close button when editor is in fullscreen mode)\n- New button to insert planlove brackets (e.g., \"[]\")\n- `Ctrl` + `s` will now save your plan\n- Reordered toolbar buttons to put formatting buttons first\n- \"Change Plan\" button aka save button gets a fun disk icon\n- Roll back previous change that tried to target all editors. Only apply to the main Plan text editor for now (not notes, secrets)\n\n### v1.4.1 (February 21, 2024)\n\n- Set SVG fill to `currentColor` to improve stylesheet compatibility\n\n### v1.4.0 (February 8, 2024)\n\n- Use icons for buttons to make it slicker and more editor-like\n- New shortcuts! `CTRL` + `B`, `CTRL` + `I`, and `CTRL` + `K` for bold, italic, and link, respectively\n- Add GPV3 license now that I'm using Dashicons icons from the WordPress project\n\n### v1.3.0 (January 31, 2024)\n\n- Switch @includes to @match for better Tampermonkey support\n- Run on ALL plans pages, not just the editor\n- Select the first `textarea` on every page (#5)\n\n### v1.2.0 (January 31, 2024)\n\n- Put leading and trailing whitespace in selections outside of wrapped text (bold, italic, links). (#7)\n- Place cursor inside bold/italic/link buttons if no text is selected (#6)\n- Detect whether selected text is a link and place selection accordingly when making a link (#1), props to [marcouke] for the nudge on this one\n\n### v1.1.0 (January 28, 2024)\n\n- Remove newline following `\u003chr\u003e` tag. That was too opinionated. (Good excuse to test Tampermonkey updates)\n- Add CONTRIBUTING.md and this changelog section\n\n### v1.0.0 (January 27, 2024)\n\n- Initial release\n\n## Credits\n\nMark Root-Wiley ([rootwile])\n\n## Open Source\n\n- [GrinnellPlans Source on Github](https://github.com/grinnellplans/)\n- Editor icons from [Dashicons](https://github.com/WordPress/dashicons/)\n- [Save icon](https://thenounproject.com/icon/save-1050704/) from Noun Project (downloaded from licensed account)\n\n## Other Plans Userscripts\n\n- [PlansPlus](https://github.com/niqjohnson/PlansPlus)\n- [NewLove](https://github.com/grinnellplans/Newlove)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrwweb%2Fplans-editor-toolbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrwweb%2Fplans-editor-toolbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrwweb%2Fplans-editor-toolbar/lists"}