https://github.com/meeehdi-dev/tt
⏰ Simple and intuitive time tracker
https://github.com/meeehdi-dev/tt
Last synced: about 1 month ago
JSON representation
⏰ Simple and intuitive time tracker
- Host: GitHub
- URL: https://github.com/meeehdi-dev/tt
- Owner: meeehdi-dev
- License: mit
- Created: 2025-06-14T14:13:32.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-14T14:17:03.000Z (about 1 year ago)
- Last Synced: 2025-06-14T15:28:28.336Z (about 1 year ago)
- Language: Vue
- Size: 58.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tt
A sleek, keyboard-centric weekly time-tracking and calendar application built for speed. `tt` helps you block time,
manage projects, and analyze your productivity seamlessly.
## Features
- **Weekly Time Blocking:** Click and drag on the calendar grid to create time slots and log events quickly.
- **Project Management:** Categorize your time with custom color-coded projects.
- **Productivity Insights:** View daily progress indicators and summarize your time spent per project using charts.
- **Highly Customizable:** Adjust your start/end of the day, work day duration, and your preferred start day of the
week.
- **Keyboard First:** Fully navigable via keyboard shortcuts for minimal friction.
- **Secure & Synced:** Authenticated sessions with database synchronization.
## Keybinds
| Keybind | Action |
| -------------------- | ------------------------------------ |
| `h` / `←` | Navigate to the previous week |
| `l` / `→` | Navigate to the next week |
| `↑` / `↓` | Reset calendar to the current week |
| `r` | Open the Summary/Reports modal |
| `s` | Open Settings (General tab) |
| `p` | Open Settings (Projects tab) |
| `g` | Open the project's GitHub repository |
| `Esc` | Close the active modal |
| `Cmd/Ctrl` + `Enter` | Save/Submit the current event |
## Technical Details
Built with a modern, type-safe stack:
- **Framework:** [Nuxt 4](https://nuxt.com/) (Vue 3, Composition API)
- **UI & Styling:** [Tailwind CSS v4](https://tailwindcss.com/) & [Nuxt UI v4](https://ui.nuxt.com/)
- **State & Utils:** [@vueuse/core](https://vueuse.org/) & Nuxt standard composables
- **Database:** PostgreSQL via [Drizzle ORM](https://orm.drizzle.team/)
- **Authentication:** [Better Auth](https://better-auth.com/)
- **Runtime Validation:** [Zod](https://zod.dev/)
- **Package Manager:** [pnpm](https://pnpm.io/)
## Local Development
This project uses [pnpm](https://pnpm.io/) as its package manager.
**1. Install dependencies**
```bash
pnpm install
```
**2. Database Setup** Generate and run migrations:
```bash
pnpm run db:generate
pnpm run db:migrate
```
**3. Start the Development Server** Start the development server on `http://localhost:3000`:
```bash
pnpm run dev
```
**4. Build for Production**
```bash
pnpm run build
pnpm run preview
```