An open-source digital planner generator. Runs entirely in the browser — no install required — and produces a cross-year planner with fixed page ordering, exportable as SVG or PDF.
中文说明见 README-cn.md
Live Demo: https://fengdonglu.github.io/OpenTecho/
- Runs in the browser: pure frontend, no installation, all data processed locally (nothing is uploaded)
- Installable & offline (PWA): install it as an app from the browser and keep using it offline after the first visit
- Remembers your settings: year / theme / language / week start / appendix counts are saved locally and restored on reload
- Cross-year layout: previous year Q4 (Oct–Dec) → full year (Jan–Dec) → next year Q1 (Jan–Mar), each month followed by its weekly pages
- Lunar calendar & holidays: lunar conversion via lunar-javascript, plus statutory and folk holiday markers
- Multiple themes: Minimal / Sakura / Milk Tea / Lemon / Matcha / Cyan / Indigo / Grape, with a color/grayscale toggle for export
- i18n: 简体中文 / 繁體中文 / English
- Configurable week start: Monday / Sunday
- Export: SVG (single page or all pages) or PDF (200dpi JPEG, B6 single page 125×176mm, B5 spread 250×176mm), with progress and cancel
| Three-year calendar | Current-year calendar |
|---|---|
 |
 |
| Monthly | Weekly |
 |
 |
Vue 3 · TypeScript · Vite · Pinia · jsPDF · lunar-javascript
npm install
npm run dev # dev server at http://localhost:3000
npm run build # type-check + production buildsrc/
├── components/preview/ # SVG preview component
├── generators/ # document assembly (cross-year ordering)
├── locales/ # Chinese/English messages
├── stores/ # Pinia state
├── templates/ # page templates: three-year/yearly/monthly/weekly/intro/grid/blank/contact/meeting
├── types/ # type definitions
└── utils/ # date, lunar, holiday, svg, pdf, download
public/ # favicon & static assets
- Set the year (auto-inferred from the current quarter), theme, week start and language
- The sidebar index follows
Overview → prev Q4 → full year → next Q1 → Appendix; click to jump - The appendix contains a "Guide" page plus configurable counts of "Grid", "Blank", "Contacts" and "Meeting Notes" pages
- The right panel previews the current page; use prev/next or type a page number to jump
- Download SVG (single/all) or export PDF
The project currently implements only a small part of the PAL methodology.
- Slogan / annual theme — filled in at the start of the year, referenced by the year review
- Year review page — compared against the slogan set at the start of the year
- More PAL methodology features — to be scoped
- Appendix content — candidates: 24 solar terms table, zodiac-year reference, unit/paper conversion
- Extract core engine into an NPM package (
@opentecho/core)
- GitHub Pages: pushing to
main/masterauto-builds and deploys (see.github/workflows/deploy.yml). The deployed site is a PWA — open it and use the browser's Install action to add it as an offline app. - Self-hosted: pushing a
v*tag triggers a release workflow that buildsdist, packages it into a zip, and uploads it as a release asset — download and serve the extracted folder with any static file server. Note: PWA install/offline requires serving over http(s) (e.g.npx serve dist); openingindex.htmlviafile://will not work.
This project is a programmatic implementation of the PAL planner by 「不是闷」. The distinctive I-beam axis (工字轴) layout idea comes from PAL. Many thanks to the author for the thoughtful design — do check out the original for more usage ideas.
Built with Vibe Coding.