ADHD-Closet

Welcome to Twin Style Documentation

Your ADHD-friendly wardrobe organizer powered by Google Gemini AI

Twin Style leverages the power of Google’s Gemini AI (the “twins” reference) to help you manage your wardrobe effortlessly. The dual nature of your style meets AI assistance.

Quick Links

- :material-rocket-launch: **[Get Started](/ADHD-Closet/user-guides/TUTORIAL.html)** New here? Start with the quick tutorial - :material-chat-question: **[FAQ](/ADHD-Closet/user-guides/FAQ.html)** Common questions answered - :material-wrench: **[Troubleshooting](/ADHD-Closet/user-guides/TROUBLESHOOTING.html)** Having issues? Find solutions here - :material-github: **[Contributing](/ADHD-Closet/CONTRIBUTING.md)** Want to help? Read the contributor guide

What is ADHD Closet?

ADHD Closet helps you organize your clothing with AI-powered tools designed specifically for ADHD-friendly workflows. Take photos of your clothes, let AI generate clean catalog images and suggest categories, then get instant outfit recommendations based on weather, mood, and time constraints.

Key Features

• Quick Item Capture - Add items in ~30 seconds via camera or gallery
• AI Catalog Generation - Transform real photos into professional catalog images
• Smart Categorization - AI automatically detects categories, colors, patterns, and attributes
• Outfit Generation - Get AI-powered outfit suggestions with “Panic Pick” for instant decisions
• ADHD-Optimized Design - Minimal friction, decision paralysis reducers, progressive disclosure
• Mobile-First - Optimized category-based navigation on mobile
• PWA + Native Support - Install as a Progressive Web App or build as a native iOS/Android app

Documentation Structure

For Users

• Tutorial - Step-by-step walkthrough
• FAQ - Frequently asked questions
• Troubleshooting - Problem solving guide

Features

• Categories - How items are organized
• Attributes - Item metadata and details
• AI Models - Choosing the right models
• Image Generation - Catalog image features
• NFC Tags - Track items with NFC
• Mobile Apps - PWA and native apps

For Developers

• Architecture - System design
• Contributing - Contribution guidelines
• API Reference - Complete API docs
• Deployment - Production setup
• Stack Validation - Tech stack validation report (2026-02-15)
• Context7 Library IDs - Library ID reference for documentation queries

Quick Start

# Clone the repository
git clone https://github.com/shelbeely/ADHD-Closet.git
cd ADHD-Closet

# Start database services
docker compose up -d

# Set up the app
cd app
cp .env.example .env
# Edit .env and add your OPENROUTER_API_KEY

# Install dependencies and run
bun install
npx prisma migrate dev
bun dev

Visit http://localhost:3000 🎉

Need Help?

1. Check the FAQ for common questions
2. Read Troubleshooting for problems
3. Open a GitHub Discussion for questions
4. Open a GitHub Issue for bugs or feature requests

---

Built with 💜 for people with ADHD