Chrome Side Panel extension to schedule developer sprints, flag overlapping dates with split cells, guard your monthly rest buffer, and get on-demand Hybrid AI assistance (on-device Gemini Nano with Firebase AI Logic cloud fallback).
Video tutorial on Dev Cadence v0.2.0:
Logging multiple hackathons, bounties, and projects across disconnected calendars causes:
- Overcommitment: Planning new work without seeing overlapping sprint dates.
- Date Collisions: Unnoticed clashing crunch periods and simultaneous deadlines.
- Burnout: Zero visibility into remaining rest days, leading to missed deadlines.
Dev Cadence lives directly inside Chrome's Side Panel to track sprint workload and rest days alongside your browser tabs.
- Extract from Page: Click Extract from Page inside the Sprint form on any standard webpage to read the active tab's selected or visible text on demand, extract structured JSON (
title,deadline) viaSchemaconstraints, and auto-fill the form's Title, URL, and Deadline. - AI Pace Advisor: Appears in the Capacity Bar when sprints overlap or your monthly rest buffer is short (hidden for past months). Deterministic JavaScript computes exact overlapping dates, deadline priority, and rest deficit, while Hybrid AI turns those facts into a concise markdown recommendation.
- Transparent Execution: Displays an
On-Device(Chrome built-in Gemini Nano) orCloud(Gemini 4 Hydrogen fallback via Firebase AI Logic) badge, supports click-to-stop cancellation (AbortController), and automatically hides the AI badge if you manually edit extracted fields. - Production App Check: Secured with Firebase App Check via a
CustomProviderbacked by a Firebase Cloud Function (2nd Gen) (getAppCheckToken) restricted to allowed extension origins.
- Interactive Grid: Displays active sprint periods with custom colors and emojis.
- Split-Cell Gradients: Overlapping sprints dynamically split cells diagonally (
linear-gradient). - Day Numbers: Numbers stay clear at the top; bottom cell indicators follow a strict priority (
START/END/1 DAYβ sprint emojis βTODAY) so cells stay uncluttered. - Deadlines & Popovers: Deadlines are flagged (
π). Click or hover any busy day for quick event details.
- Smart Range Anchor: Click any day to auto-span a sprint by your configured
Build Days. Click later days to stretch or shrink the sprint; click before the start to shift the start date. - Calendar Preview: Editing dates in the inline form highlights the sprint range with a dashed border, soft tint,
START/ENDbadges, and deadline flag (π). - Tracker Hover Highlight: Hovering a saved sprint in the Tracker highlights its range and deadline on the calendar (can be toggled in Settings).
- Date & Overlap Validation: Enforces valid
Start Date,End Date, optionalDeadline, and a max of 2 overlapping sprints per day.
- Compact Capacity Bar: Visual breakdown of your monthly days (
BUILD,FREE,REST X/Yd):- π΅ Blue (Build): Scheduled sprint days in the month.
- π’ Green (Free): Available days remaining before dipping into rest.
- π£ Purple (Rest): Target rest days (
0β31days configured in Settings).
- Cards & Table Modes: Switch between compact cards and a table view, sorted by earliest deadline first.
- Status Filter: Filter entries by lifecycle status (Interest, Join, Early, Draft, Done).
- Month-Aware List: Shows every sprint touching the selected month, including sprints that span across two months.
- 3 Built-In Themes:
Ocean Slate,Obsidian Brass, andWarm Vellum(default). - 3 Font Presets:
Bahnschrift,Geometric(Plus Jakarta Sans), andMarcellus. - Font Scaling:
90%,100%, and110%scaling via CSS tokens with auto-save.
- Local Storage: Uses
chrome.storage.localin the extension with fallback tolocalStorage. - JSON Backup: 1-click
Export JSONandImport JSONto move data between devices. - Data Management & Transparency: Confirmation-protected Clear Sprints and Factory Reset controls,
LegalandContact Supportmodals, and a public Privacy Policy.
Dev Cadence originally existed before November 11, 2026 (v0.2.0 tag) as a local-only Chrome Side Panel hackathon tracker with no AI or Firebase integration. During #BuildHybridAI 2026 (v0.3.0 β v1.0.0), it was expanded into a Hybrid AI capacity planner:
-
Firebase AI Logic Hybrid Inference (
src/utils/hybridAi.js): Integratedfirebase ^13.4.0(InferenceMode.PREFER_ON_DEVICEwithgemini-4-hydrogencloud fallback), structured JSON output (Schema), and cancelable generation (AbortControllerwith animated loading dots and on-device abort racing). -
Firebase App Check + Cloud Functions (
functions/index.js): Implemented a 2nd Gen Cloud Function (getAppCheckToken) usingfirebase-admin/app-checkwith origin validation to mint production App Check tokens for Chrome Extension MV3CustomProvider. -
Active-Tab Sprint Extractor (
src/components/modals/AiExtractBar.jsx): AddedactiveTab+scriptingon-demand page extraction to auto-fill sprint title, URL, and deadline, withOn-Device/Cloudbadges (AiSourceBadge) that hide if extracted fields are edited manually. -
Deterministic + Hybrid AI Pace Advisor (
src/utils/scheduleAdvisor.js,src/components/CapacityBar.jsx): Added pure JS overlap detection, shared deadline-first sprint sorting, and rest-deficit calculation paired with friendly Hybrid AI phrasing rendered viareact-markdown, with collapse toggle, scroll, and past-month hiding. -
Calendar & Form Refinements: Limited daily sprint overlap to max 2, defaulted new sprint start dates to today, prioritized cell badges (
START/END/1 DAYβ emojis βTODAY) with dimmed unrelated emojis during preview, and added a back button to the inline Sprint form. -
UI & Release Polish: Set Warm Vellum as the default theme, centered the header subtitle, grouped all project constants, updated
LegalModal, and added PRIVACY.md for Chrome Web Store submission.
-
Added an AI settings tab to check Chrome on-device AI (
Gemini Nano) status and download the local model. -
Migrated font sizes across the app to CSS scale tokens (
10/12/14px,12/14/16px,14/16/18px) and replacedCinzelwithMarcellus. -
Defaulted the calendar to the current month and added a header logo click to return to the current month.
-
Made the main panel scrollable between the fixed header and footer, and opened Analytics in the full panel view with a return action.
-
Converted the Sprint form into an inline card, aligned
Start Date,End Date, andDeadlinein one row, and madeDeadlineoptional. -
Removed silent date auto-correction and added inline validation errors, including
Deadlinerange checks against start and end dates. -
Added single-day (
1 DAY) event support and responsive layout rules for multiple badges (TODAY,START,END) and emojis in calendar cells. -
Updated the color and emoji palette for visibility across light and dark themes, and added screen-reader labels (
aria-label,aria-pressed). -
Added descriptions to status dropdown options, updated theme names, and replaced hackathon/Devpost labels with universal sprint terminology.
-
Extracted
SprintLinkButtonwith an updated tooltip and replaced emojis in the Sprint form and Settings buttons with vector SVG icons. -
Redesigned
CapacityBarinto a compact single-line summary (BUILD,FREE,REST X/Yd) and unified segment colors across themes. -
Updated
Settings -> Generalwith dropdown selectors, a single row forBuild Days,Rest Days(0β31), andHoverwith info tooltips, plus local JSON backup (Export JSON/Import JSON). -
Added a
Contact Supportmodal with Discord webhook delivery, updated the license to Apache 2.0, simplified footer links, and moved the version label to Settings. -
Added ESLint configuration, split all components and CSS files under 250 lines into domain modules, and removed unused styles and exports.
-
Added a hackathon URL field.
-
Added monthly hackathon count badges by status.
-
Updated status colors and names to align with the Devpost hackathon lifecycle.
-
Added analytics to estimate event durations and average work days.
-
Improved Tracker navigation with month switching.
-
Added Schedule highlighting for Tracker items on hover, with an option to disable the effect.
-
Refined Table View by removing emoji clutter.
-
Improved Tracker sorting by start date.
- Framework: React 19 + Vite 6 +
react-markdown - Styling: Modular Vanilla CSS with CSS tokens and responsive scaling
- Platform: Chrome Extension Manifest V3 (
sidePanel,storage,activeTab,scripting, background service worker) - Hybrid AI & Backend: Firebase AI Logic (
firebase ^13.4.0), Firebase App Check (CustomProvider), Firebase Cloud Functions 2nd Gen (firebase-functions ^7.0.0,firebase-admin ^13.6.0, Node 24), Chrome Prompt API (Gemini Nano), andgemini-4-hydrogencloud fallback
dev-cadence/
βββ functions/ # Firebase Cloud Functions 2nd Gen (App Check token minter)
βββ public/ # Extension manifest, icons, background service worker
βββ src/
β βββ components/ # Calendar, Tracker, CapacityBar, AiSourceBadge, Header, Footer, SVG icons
β β βββ modals/ # Inline LogModal, AiExtractBar, Settings, Analytics, Legal, Contact, Confirm
β βββ hooks/ # Storage state and calendar selection flow hooks
β βββ styles/ # Modular domain stylesheets (calendar, tracker, modals, analytics)
β βββ utils/ # Hybrid AI, schedule advisor, Nano status, date math, validation, storage
β βββ App.jsx # Root state coordinator
β βββ constants.js # Themes, typography presets, AI config, status options, and limits
β βββ index.css # Stylesheet entry point
βββ PRIVACY.md # Public privacy policy
βββ LICENSE # Apache License 2.0
βββ package.json
git clone https://github.com/vero-code/dev-cadence.git
cd dev-cadence
npm installCopy .env.example to .env and fill in your Firebase Web App credentials and App Check endpoint:
cp .env.example .envIf deploying the App Check Cloud Function yourself, also configure functions/.env from functions/.env.example (APPCHECK_WEB_APP_ID, ALLOWED_EXTENSION_IDS) and run firebase deploy --only functions.
- Web preview: run
npm run devand open http://localhost:5173. - Chrome Extension:
npm run build
- Open
chrome://extensionsin Chrome and enable Developer mode. - Click Load unpacked and select the
dist/folder. - Pin Dev Cadence and open it in the Chrome Side Panel.
- Open
- Hybrid AI Extract from Page: Open any hackathon or project page, click
+in Tracker, click Extract from Page, and confirm title, URL, deadline, and theOn-Device/Cloudbadge populate automatically. - Hybrid AI Pace Advisor: Log two overlapping sprints (or lower available rest days below
Rest Days), then click AI Pace Advisor in the bottom Capacity Bar. Click again while analyzing to test cancellation. - Collision Split & Live Sync: Edit dates in the Sprint form and watch diagonal split cells and dashed preview border update in real time.
- Backup & Restore: Export sprints to JSON in
Settings -> Data Managementand import them back. - On-Device Model Inspection: Tested locally in Chrome with
nano_v3_gpu_high_tier_model(Gemini Nano). You can inspect the installed model and status atchrome://on-device-internals, or check/download it viaSettings -> AI.
Apache License 2.0. Expanded into a Hybrid AI capacity planner for developers during #BuildHybridAI 2026. Originally created for Build With AI: Basics as a hackathon pacing planner.
