Skip to content

Year Planner for ReactPlan the whole year in one component

A 12–36 month, 37-column planning grid for construction, logistics, staffing and every team that plans a year at a glance.

The Northwind Construction plan in the Year Planner

A full year, not a scroll bar ​

The default 14-month window shows December of the previous year, January to December, and January of the next year. The component can widen to 36 months without changing the renderer: the month rows are data, not a hard-coded calendar.

Northwind Construction's 2027 plan in the Year Planner

The full construction demo is a working application: double-click a date to allocate a project, right-click a bar to edit or delete it, and reload the page to see the plan restored from browser storage.

Start with one component ​

tsx
import { YearPlanner } from "@blendsdk/react-year-planner";
import "@blendsdk/react-year-planner/styles.css";

const layers = [{ id: "build", name: "Build", channel: "ribbon", color: "#1d4e89" }];
const projects = [
  {
    id: "riverside",
    kind: "activity",
    layerId: "build",
    period: { kind: "all-day", startDate: "2027-02-02", endDateExclusive: "2027-05-28" },
    title: "Riverside offices",
    version: 1,
  },
];

export function Plan() {
  return <YearPlanner year={2027} layers={layers} defaultItems={projects} />;
}
Status: 0.3.2 is published to npm with provenance. Install it with pnpm add @blendsdk/react-year-planner.

Explore ​

Start hereWhat you will find
Your first plannerInstall the component, add layers and projects, and print the year
Controlled commandsRoute create, move, resize and delete through a host backend
Fit the grid to a hostMeasure a bounded region and keep 24 px targets
Host-owned context menuRight-click a date, item or annotation and render your own menu
ExamplesLive demos, themes, print and design-system adapters
Story indexEvery story in the built Storybook
StorybookThe full interactive component catalogue
API referenceGenerated TypeDoc for all three packages
Localization45 locale catalogues and message overrides

Free for internal use. Built with VitePress, Storybook and TypeDoc.