# Tweloc

> A modern productivity and goals tracking web app with weekly planning, AI-powered task management, and cross-platform support.

## Overview

Tweloc is a web-first productivity app that helps users plan their week, track goals, and build habits. It features a Tweek-style weekly planner, monthly calendar view, AI auto-planning, voice input, and a comprehensive dashboard with analytics.

## Core Features

- **Weekly Planner**: 7-day calendar grid with drag-and-drop task ordering, ruled-line notebook design
- **Monthly Calendar**: Full month grid with task dots, click-to-add task on any day
- **Dashboard**: Completion rates, priority breakdown, streaks, overdue alerts, time-of-day greeting
- **Voice Copilot**: Floating button — speak to add tasks, AI parses and previews before inserting
- **AI Auto-Planning**: Cloudflare Workers AI (Llama 4) suggests optimal task scheduling for the week
- **NLP Search**: Cmd+K search with natural language queries ("due today", "high priority", "overdue") + Fuse.js fuzzy matching
- **Recurring Tasks & Streaks**: Daily/weekly/monthly/yearly recurrence with streak tracking
- **Categories**: Color-coded folders for organizing tasks
- **Bulk Actions**: Multi-select tasks for batch complete/archive/delete/priority change
- **Offline Support**: Works without internet, syncs when reconnected
- **Dark Mode**: Full dark/light theme support
- **iOS App**: Native SwiftUI app on TestFlight with UI parity to web

## Tech Stack

- **Frontend**: Next.js 16, React 19, TypeScript 5, Tailwind CSS v4
- **Backend**: Supabase (PostgreSQL + Auth + Realtime)
- **AI**: Cloudflare Workers AI (Llama 4 Scout)
- **iOS**: Swift 6, SwiftUI, SwiftData, iOS 26+
- **Testing**: Vitest (unit), Playwright (E2E)
- **Deployment**: Vercel (web), TestFlight (iOS)

## URLs

- Production: https://tweloc.com
- Features: https://tweloc.com/features
- Integrations: https://tweloc.com/integrations
- Roadmap: https://tweloc.com/roadmap
- App: https://tweloc.com/app
- Login: https://tweloc.com/login

## Authentication

Magic link (OTP) email authentication via Supabase Auth. Anonymous users can use the full app with localStorage storage.

## API & Integrations

Tweloc ships a public REST API (API-key authenticated) for managing tasks programmatically:

- `GET /api/v1/tasks` — list and filter tasks by status, priority, or date
- `POST /api/v1/tasks` — create a task
- `PATCH /api/v1/tasks/{id}` — update a task
- `DELETE /api/v1/tasks/{id}` — delete a task
- `GET /api/v1/tasks/summary` — task summary/analytics
- `POST /api/v1/api-keys` — generate an API key (requires an authenticated session)

A Model Context Protocol (MCP) server lets AI assistants like Claude and ChatGPT list, add, complete, and update tasks on the user's behalf. See https://tweloc.com/integrations. Internally the app uses Supabase (PostgreSQL) with Row Level Security.

## Data Model

Core entities: Goals (tasks), SubGoals (subtasks), Categories, Reminders, Profiles.

Goals have: title, description, deadline, priority (low/medium/high/urgent), status (not_started/in_progress/completed/archived), recurrence settings, streak tracking, estimated time, sort order, color highlighting.

## Contact

Built by Gaurav Pandey.