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 (управления персоналом), точно повторяющего дизайн 'Dashboard – calendar' из Figma. В нём есть календарь, заявки на отпуск и несколько других страниц для работы с внутренними процессами компании.
Это работающий сервис или просто демо интерфейса?Это чисто фронтенд-приложение без серверной части: всё работает в браузере, а данные сохраняются в localStorage вместо базы данных.
Как его запустить?Клонируйте репозиторий и выполните стандартный порядок для Next.js (npm install, затем npm run dev с Turbopack). Приложение сразу откроется на странице отпусков — маршруте по умолчанию, который воспроизводит дизайн из Figma.
Нужны ли база данных или API-ключи, чтобы попробовать?Нет, для установки и запуска достаточно Node.js и npm. Базы данных, сервера или API-ключей не требуется, так как это статическое приложение на Next.js/React, которое хранит всё в localStorage.
Что важно знать, прежде чем использовать это как настоящее приложение?Это визуальный прототип, а не готовый HR-инструмент: очистка данных сайта в браузере удалит ваши изменения (для этого есть встроенный сброс), а такие процессы, как согласование руководителем, пока лишь имитируются и не подключены к реальной серверной логике.
Что можно делать на странице календаря?Доступны режимы просмотра по неделе, по дню и по месяцу. Можно перетаскивать пустое место, чтобы создавать события, перетаскивать события на другие дни и тянуть за нижний край, чтобы менять их длительность. Есть отдельная полоса для событий на весь день, например праздников, и живая линия текущего времени.
Какие горячие клавиши поддерживаются?⌘K открывает поиск, N создаёт новое событие, R начинает заявку на отпуск, T переводит к сегодняшнему дню, стрелки переключают периоды, D/W/M переключают виды календаря, а ? показывает список горячих клавиш.
Как сбросить демо-данные к исходному состоянию?Перейдите в Settings → Data → Reset demo data или очистите данные сайта для этой страницы в браузере. Исходные данные относятся к неделе с 8 по 14 ноября 2026 года и содержат показатели лимитов отпусков, соответствующие исходному дизайну из Figma.
На каком стеке построен интерфейс?Next.js 16 App Router с Turbopack, React 19, TypeScript, Tailwind CSS v4 с токенами из Figma, shadcn/ui на примитивах Radix, Zustand для сохранения состояния, next-themes для тёмной темы, Sonner для всплывающих уведомлений и cmdk для командной палитры.
Какие есть похожие проекты?shadcn-admin, ui, arc-library, tweakcn, mantine, taxonomy, rare-ui, json-render
Автор
kargulstudio
Размер
0.6 MB
Звёзды
868
Обновлён
КоммитOct 26
Возраст
23 д
Коммиты · 90 дней