Doux - AI Task Manager Development by Alex JanousekDoux - AI Task Manager Development by Alex Janousek

Doux - AI Task Manager Development

Portfolio project
Alex Janousek
View completed work

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

0 likes · 11 views · Nov 6, 2025

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

Tags