Timify is a self-hosted time tracking application inspired by Toggl, built for speed and simplicity. It runs entirely on SQLite via Drizzle ORM, targets sub-100ms response times, and works offline-first. Organize work into projects, start and stop timers with a single click, attach tags to entries for categorization, and view daily hours in built-in bar chart reports.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Aking16/timify/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Clone the repo, configure environment variables, and have Timify running locally in minutes.
Self-Hosting
Deploy Timify to your own infrastructure with full control over your data.
Core Features
Explore projects, time tracking, tags, and reports in depth.
Reference
Browse the full Server Actions API and database schema reference.
What Timify Does
Timify gives you a focused set of time-tracking primitives:Projects
Group time entries under named projects with optional hourly rates and colors.
Time Tracking
Start, stop, and edit time entries with real-time duration display.
Tags
Attach multiple tags to any time entry for flexible categorization.
Reports
View daily hours as a bar chart for any project with a custom date range.
Technology Stack
Next.js 16 + React 19
App Router with React Server Components and Server Actions for low-latency mutations.
Drizzle ORM + SQLite
Type-safe SQL queries against a local SQLite file via libsql — no external database needed.
better-auth
Email and password authentication with session management out of the box.
Tailwind CSS v4 + shadcn/ui
Utility-first styling with accessible Radix-based components and dark mode support.
Get Started
Clone and install
Clone the repository and install dependencies with your preferred package manager.
Set environment variables
Copy
.env.example and configure DB_FILE_NAME, BETTER_AUTH_SECRET, and BETTER_AUTH_URL.Start the dev server
Run
npm run dev and open http://localhost:3000.See the Quickstart guide for the full step-by-step walkthrough with all commands.