Doux - AI Task Manager Development

Alex Janousek

Completed work

Architect

AI Developer

Next.js

Supabase

Vercel

Computer Software

Doux - AI Task Manager

A personal task management application powered by Claude AI that allows you to manage your tasks through natural language conversations.

Features

Conversational Interface: Interact with Claude AI to create, update, and manage tasks using natural language

Smart Task Management: Automatic priority detection, date parsing, and context awareness

Today View: Focus on today's tasks with intelligent grouping by priority and due dates

Real-time Updates: Live updates when tasks change

Secure: Password-protected with session management

Responsive: Works great on desktop and mobile devices

Credit System: Daily AI operation limits with optional Pro subscription for power users

Tech Stack

Frontend: Next.js 14, TypeScript, Tailwind CSS

Backend: Next.js API Routes

Database: Supabase (PostgreSQL)

AI: Claude AI (Anthropic)

Authentication: Custom session-based auth

Payments: LemonSqueezy integration for subscriptions

Deployment: Vercel (recommended)

Quick Start

Prerequisites

Node.js 18+

Supabase account

Claude API key

Google OAuth credentials (for multi-tenant mode)

Setup

git clone <repository-url>
cd doux
npm install
cp .env.example .env.local  # Fill in your environment variables
npm run dev

Environment Variables

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://[project].supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=[key]
SUPABASE_SERVICE_KEY=[key]

# Claude AI
CLAUDE_API_KEY=sk-ant-[key]

# NextAuth.js (for OAuth)
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=[32+ character secret]
GOOGLE_CLIENT_ID=[google-oauth-id]
GOOGLE_CLIENT_SECRET=[google-oauth-secret]

# Security
SITE_PASSWORD=[password-for-basic-auth]
SESSION_SECRET=[32-char-secret]

# App Configuration
NEXT_PUBLIC_APP_URL=http://localhost:3000
NODE_ENV=development

Database Setup

Create Supabase project

Run database.sql in SQL Editor (includes all security & performance optimizations)

Configure environment variables

Development

Commands

npm run dev          # Development server
npm run build        # Production build
npm run test         # Run tests
npm run lint         # Lint code
npm run typecheck    # TypeScript checks
npm run deploy       # Automated deployment pipeline

Git Workflow

npm run git:setup           # Initial branch protection setup
npm run git:start-feature   # Start new feature from dev
npm run git:finish-feature  # Merge feature to dev
npm run git:create-pr       # Create PR from dev to main
npm run git:status          # Check workflow status

Testing

npm run test:ci      # Run all tests with coverage
npm run test:e2e     # End-to-end tests
npm run dev:test     # Start test server on port 3001

Architecture

Tech Stack

Frontend: Next.js 14 with TypeScript and Tailwind CSS

Database: Supabase (PostgreSQL) with RLS and optimized indexes

AI: Claude API for natural language processing

Auth: NextAuth.js with Google OAuth (multi-tenant)

Hosting: Vercel with CI/CD via GitHub Actions

Key Features

Natural language task management

Real-time updates via Supabase subscriptions

Mobile-responsive design with dedicated routes

Credit system with daily limits (10 free, 100 pro)

Multi-tenant architecture with Google OAuth

Progressive deployment (staging → production)

Project Structure

src/
├── app/                 # Next.js App Router
│   ├── api/            # API routes
│   └── (routes)/       # Page routes
├── components/         # React components
├── lib/               # Utilities & integrations
└── types/             # TypeScript definitions

Deployment

Environments

Production: https://doux.today (manual deploy from main)

Staging: Auto-deployed from main branch

Preview: Auto-generated for each PR

CI/CD Pipeline

Automated tests, security scans, and build verification

Quality gates enforce all checks pass before production

Progressive deployment with manual production approval

Optimized 3-stage pipeline (40-50% faster)

Database Architecture

Separate staging and production databases

Security hardening with SQL injection prevention

Row Level Security (RLS) on all tables

Performance optimizations with proper indexing

Usage Examples

Creating Tasks

"Add a task to buy groceries"

"Create urgent task: Call dentist tomorrow"

"I need to finish the report by Friday"

Managing Tasks

"Mark the first task as done"

"Show me today's tasks"

"What's urgent?"

"Complete all grocery tasks"

Querying

"What do I have today?"

"Show me this week's tasks"

"What's overdue?"

Contributing

See CLAUDE.md for detailed development guidelines and Claude Code instructions.

Payment System

Doux includes a credit-based payment system:

Free Tier: 10 AI operations per day

Pro Tier: 100 AI operations per day ($9.99/month)

Credit Reset: Daily at midnight UTC

Secure Payments: Powered by LemonSqueezy

Payment Documentation

User Guide - How credits work, upgrading, and managing subscriptions

Developer Guide - Technical implementation and API reference

Operations Guide - System monitoring and maintenance procedures

License

MIT License

Support

For issues and questions:

Check existing GitHub issues

Review CLAUDE.md for development guidance

Create a new issue with detailed information

origin/main

Like this project

Completed work

Posted Nov 6, 2025

Developed Doux, an AI-powered task manager with natural language processing.

Likes

Views