No description
Find a file
Anmol Singh Bhatia fd68e7d919
refactor: migrate web @plane/propel Tooltip to @makeplane/propel (#9726)
* refactor: migrate web @plane/propel Tooltip to @makeplane/propel

Move all 144 Tooltip call sites in apps/web from the in-repo
@plane/propel/tooltip to the published
@makeplane/propel/components/tooltip.

Prop mapping applied on every site:
- tooltipContent -> label (string)
- tooltipHeading -> folded into label + layout="stacked"
- position -> side/align (top/center omitted; it is the published default)
- isMobile -> disabled (OR'd with any existing disabled)
- renderByDefault -> dropped; the in-repo Tooltip declared but never
  used it
- className -> dropped, or mapped to sideOffset/alignOffset (3 sites)

layout is "single" for short bounded copy and "stacked" wherever the
label interpolates unbounded data (names, titles, URLs, joined lists) —
"single" is whitespace-nowrap, so long labels would overflow.

Behavior change: tooltips now open after the published 600ms default
instead of the in-repo 200ms. delay is deliberately not set per site.

ReactNode content:
- Editor toolbars map name + <kbd>shortcut</kbd> onto the published
  shortcut prop
- <br/> and fragment copy folds into one wrapping stacked string
- stickies/action-bar rendered a full <StickyNote> hover preview, not a
  tooltip; it moves to PreviewCard/PreviewCardTrigger/PreviewCardContent

Published label is a string, so DropdownButtonProps.tooltipContent,
date-range's customTooltipContent, and the two rich-filters components
narrow from ReactNode to string. rich-filters/root.tsx guards
filterConfig.tooltipContent, which stays ReactNode in @plane/types.

Folded labels use ?? "" where the source expression is nullable so they
cannot render the string "undefined" where the in-repo tooltip rendered
nothing.

Zero @plane/propel/tooltip references remain under apps/web.

* fix: address review findings on the Tooltip migration

Accessibility (CodeRabbit): Base UI wires no aria-describedby or
aria-labelledby between the tooltip trigger and its popup — verified by
rendering the published Tooltip and inspecting the DOM, the trigger comes
out as `<button data-base-ui-tooltip-trigger>` with no aria at all and the
popup has role="tooltip" but no id. So a `label` never reaches assistive
tech, and the four icon-only triggers announced as bare "button". Add an
explicit aria-label at each: extended-project-sidebar, layout-switcher,
layout-selection, and access-field. Pre-existing gap (the in-repo tooltip
sat on the same unwired Base UI trigger), fixed here since the PR touches
these sites.

AccessField now requires i18n_label and drops the optional pre-i18n
`label`, so the computed label is non-empty by construction and serves as
both the tooltip copy and the accessible name. Its only caller already
passes i18n_label for every specifier, which also retires the TODO.

Correctness: inbox issue-properties interpolated a nullable name into a
template literal, so a duplicate work item with no name rendered the
literal "undefined"; pass the name with ?? "" instead.

CodeQL useless conditional: drop `|| ""` from stickyId in action-bar —
both call sites already sit behind a guard proving recentStickyId truthy,
and StickyNote treats "" and undefined identically.

React Doctor prefer-module-scope-static-value: hoist badgeContent to
module scope as BADGE_CONTENT; it holds only static strings.

React Doctor js-combine-iterations: collapse the filter/map chains to a
single pass. The two layout switchers skip inside map instead of
pre-filtering; LabelSummary reduces project labels into the selected
names once rather than filter -> map -> join.
2026-09-01 17:15:12 +05:30
.claude/skills chore: integrate react-doctor scanning (#9223) 2026-06-09 02:02:54 +05:30
.github chore(ci): build images natively per architecture and merge by digest (#9673) 2026-08-30 15:22:21 +05:30
.husky fix: eslint (#8185) 2025-12-05 16:03:51 +05:30
.idx chore: add IDX configuration so anyone can edit the project from idx.google.com (#5398) 2024-08-28 13:52:25 +05:30
apps refactor: migrate web @plane/propel Tooltip to @makeplane/propel (#9726) 2026-09-01 17:15:12 +05:30
deployments refactor: migrate admin and web from nginx to Caddy (#9716) 2026-08-30 16:25:06 +05:30
docs fix: replace eslint with oxlint (#8677) 2026-03-03 00:46:05 +05:30
packages fix(i18n): correct broken German translations (#9715) 2026-08-31 17:09:17 +05:30
patches chore: upgrade React to 19 and React Router to 8 (#9530) 2026-08-26 17:39:36 +05:30
.dockerignore [WEB-5040] feat: admin react-router migration (#7922) 2025-11-06 13:39:35 +05:30
.env.example [INFRA-209] Remove nginx related configurations from plane community (#7406) 2025-07-14 16:38:27 +05:30
.gitattributes fix: Local Setup on Windows (#5539) 2024-09-10 17:28:18 +05:30
.gitignore fix(api): enforce workspace membership on GenericAssetEndpoint (#9212) 2026-06-04 18:49:39 +05:30
.mise.toml chore: upgrade React to 19 and React Router to 8 (#9530) 2026-08-26 17:39:36 +05:30
.node-version chore: upgrade React to 19 and React Router to 8 (#9530) 2026-08-26 17:39:36 +05:30
.npmrc fix: updated npmrc with hoist patterns (#8271) 2025-12-09 16:32:49 +05:30
.oxfmtrc.json chore: replace prettier with oxfmt (#8676) 2026-03-02 20:40:50 +05:30
.oxlintrc.json chore: upgrade React to 19 and React Router to 8 (#9530) 2026-08-26 17:39:36 +05:30
.prettierignore fix: eslint (#8185) 2025-12-05 16:03:51 +05:30
.trivyignore fix: security vulnerabilities for plane docker images (#9140) 2026-05-26 14:25:01 +05:30
AGENTS.md fix: Add docker pytest runner and fix bugs the suite surfaced (#9138) 2026-05-26 01:21:37 +05:30
CODE_OF_CONDUCT.md
CODEOWNERS chore: retire departed code owners (apps/live, ox configs) (#9504) 2026-07-29 19:39:38 +05:30
CONTRIBUTING.md [WEB-6420] chore: migrate community references from Discord to Forum (#8657) 2026-03-04 13:08:36 +05:30
COPYRIGHT.txt chore: add copyright (#8584) 2026-01-27 13:54:22 +05:30
COPYRIGHT_CHECK.md chore: add copyright (#8584) 2026-01-27 13:54:22 +05:30
docker-compose-local.yml fix: removed unused files 2026-03-25 02:04:20 +05:30
docker-compose-test.yml fix: Add docker pytest runner and fix bugs the suite surfaced (#9138) 2026-05-26 01:21:37 +05:30
docker-compose.yml Update docker-compose.yml for valkey security patch (#7926) 2025-10-09 17:15:49 +05:30
LICENSE.txt
package.json chore: upgrade React to 19 and React Router to 8 (#9530) 2026-08-26 17:39:36 +05:30
pnpm-lock.yaml chore: wire @makeplane/propel into web (#9699) 2026-08-28 00:09:16 +05:30
pnpm-workspace.yaml chore: wire @makeplane/propel into web (#9699) 2026-08-28 00:09:16 +05:30
README.md chore: remove Zenith managed hosting from README (#9693) 2026-08-27 15:11:58 +05:30
SECURITY.md Updated SECURITY.md (#5737) 2024-10-03 14:09:01 +05:30
setup.sh feat: migrate to pnpm from yarn (#7593) 2025-08-19 20:06:42 +05:30
turbo.json chore: remove posthog integration and analytics scaffold (#9634) 2026-08-24 21:07:34 +05:30



Plane Logo

Modern project management for all teams

Website • Forum • X • Documentation

Plane Screens

Meet Plane, an open-source project management tool to track issues, run sprints cycles, and manage product roadmaps without the chaos of managing the tool itself. 🧘‍♀️

Plane is evolving every day. Your suggestions, ideas, and reported bugs help us immensely. Do not hesitate to join in the conversation on Forum or raise a GitHub issue. We read everything and respond to most.

🚀 Installation

Getting started with Plane is simple. Choose the setup that works best for you:

  • Plane Cloud Sign up for a free account on Plane Cloud—it's the fastest way to get up and running without worrying about infrastructure.

  • Self-host Plane Prefer full control over your data and infrastructure? Install and run Plane on your own servers. Follow our detailed deployment guides to get started.

Installation methods Docs link
Docker Docker
Kubernetes Kubernetes

Instance admins can configure instance settings with God mode.

🌟 Features

  • Work Items Efficiently create and manage tasks with a robust rich text editor that supports file uploads. Enhance organization and tracking by adding sub-properties and referencing related issues.

  • Cycles Maintain your team’s momentum with Cycles. Track progress effortlessly using burn-down charts and other insightful tools.

  • Modules Simplify complex projects by dividing them into smaller, manageable modules.

  • Views Customize your workflow by creating filters to display only the most relevant issues. Save and share these views with ease.

  • Pages Capture and organize ideas using Plane Pages, complete with AI capabilities and a rich text editor. Format text, insert images, add hyperlinks, or convert your notes into actionable items.

  • Analytics Access real-time insights across all your Plane data. Visualize trends, remove blockers, and keep your projects moving forward.

🛠️ Local development

See CONTRIBUTING

⚙️ Built with

React Router Django Node JS

📸 Screenshots

Plane Views

Plane Cycles and Modules

Plane Analytics

Plane Pages

📝 Documentation

Explore Plane's product documentation and developer documentation to learn about features, setup, and usage.

❤️ Community

Join the Plane community on GitHub Discussions and our Forum. We follow a Code of conduct in all our community channels.

Feel free to ask questions, report bugs, participate in discussions, share ideas, request features, or showcase your projects. We’d love to hear from you!

🛡️ Security

If you discover a security vulnerability in Plane, please report it responsibly instead of opening a public issue. We take all legitimate reports seriously and will investigate them promptly. See Security policy for more info.

To disclose any security issues, please email us at security@plane.so.

🤝 Contributing

There are many ways you can contribute to Plane:

Please read CONTRIBUTING.md for details on the process for submitting pull requests to us.

Repo activity

Plane Repo Activity

We couldn't have done this without you.

License

This project is licensed under the GNU Affero General Public License v3.0.