calender-app-design README

项目的 README,来自 github.com/kargulstudio/calender-app-design。合并为一个 markdown 文件:README.md。

Kargul Calender Design Prototype

A design prototype of Kargul Workspace, a people-ops workspace built from the "Dashboard – calendar" Figma design. Live at https://calender-app-design.vercel.app.

The Time off page (/time-off, the default route) reproduces the design pixel-for-pixel; every other page in the sidebar is built in the same visual language. Everything runs in the browser — there is no backend; data persists to localStorage.

Stack

Getting started

npm install
npm run dev

Open http://localhost:3000. To return to the exact design state, use Settings → Data → Reset demo data (or clear site data).

What works

Project layout

src/
  app/                 routes (one folder per sidebar page)
  components/
    ui/                shadcn/ui primitives, themed
    shell/             title bar, sidebar, search, notifications, shortcuts
    calendar/          header, time grid, all-day row, month view, popover
    time-off/          stats panel, requests table, status badge
    dialogs/           app-wide dialogs (request, event, details, holidays…)
    pages/             page bodies for the secondary routes
  stores/              Zustand stores (app data, calendar view, overlays)
  hooks/               client-only "today"/"now"
  lib/                 types, date helpers, leave rules, seed data

The seed in src/lib/seed.ts is what the design shows: the week of Nov 8–14, 2026 with Tue Nov 10 selected, and allowance figures of 7 available, 2 pending, 3 upcoming.

License

MIT © 2026 Kargul Studio

calender-app-design (kargulstudio/calender-app-design)

正在搜索数据库…

这是什么?这是 'Kargul Workspace' 的前端设计原型。它是一个人事运营(HR)工作台,依据 Figma 的 'Dashboard – calendar' 设计像素级还原,涵盖日历、休假申请以及其他若干公司运营页面。
这是在线服务,还是仅为前端演示?这是纯前端 Web 应用,没有后端服务器:一切都在浏览器中运行,所有数据都保存在 localStorage 中,而不是数据库里。
我该如何运行它?克隆仓库,然后执行标准的 Next.js 流程(先 npm install,再用 Turbopack 执行 npm run dev)。启动后会直接打开 Time-off 页面,这是还原 Figma 设计的默认路由。
试用它需要数据库或 API 密钥吗?不需要,只需安装并运行 Node.js/npm 即可。它是静态的 Next.js/React 应用,所有数据都存在 localStorage 中,因此不涉及数据库、服务器或 API 密钥。
在把它当作真正的应用来依赖之前,我需要了解什么?它是视觉原型,而非可投入生产的人事工具:清除浏览器的网站数据会抹掉你的编辑内容(应用内提供了重置功能作为替代);经理审批等流程只是模拟稿,并未连接真正的后端逻辑。
日历页面能做什么?支持周、日、月三种视图;可以在空白处拖动来创建事件,拖动事件可将其移到其他日期,拖动底边可调整时长。全天栏用于显示节假日,并带有实时的“当前时间”线。
支持哪些键盘快捷键?⌘K 打开搜索,N 新建事件,R 发起休假申请,T 跳到今天,方向键在各时间段之间移动,D/W/M 切换日历视图,? 显示快捷键列表。
如何把演示数据重置回初始状态?前往 Settings → Data → Reset demo data;或清除该页面的浏览器网站数据。初始数据对应 2026 年 11 月 8 日至 14 日这一周,其中的休假额度数字与原始 Figma 设计一致。
设计依赖哪些界面技术栈?Next.js 16 App Router 配合 Turbopack、React 19、TypeScript、映射到 Figma 设计令牌的 Tailwind CSS v4、基于 Radix 原语的 shadcn/ui、用于持久化状态的 Zustand、用于深色模式的 next-themes、用于消息提示的 Sonner,以及用于命令面板的 cmdk。
大小
0.6 MB
星标
868
更新
提交Oct 26
时长
23天
提交 · 90 天