flowstate/README.md

Flowstate

A modern, high-performance Kanban & Workflow web application designed to help you lock in and enter the productivity flow.

🛠️ Tech Stack

• Framework: Next.js 16 (App Router, Route Groups)
• UI & Styling: React 19, Tailwind CSS v4
• Authentication: Auth.js v5 (NextAuth) with Credentials Provider & bcrypt hashing
• Database & ORM: PostgreSQL managed via Drizzle ORM & Drizzle Kit

📂 Architecture & Structure

The project uses Next.js Route Groups to separate public and protected application areas cleanly:

• app/(auth)/ — Public authentication routes (Login, Register)
• app/(app)/ — Protected workspace & dashboard routes (Sidebar, Header, Kanban Board)
• app/api/ — Backend API endpoints & Auth handlers (/api/auth/register, [...nextauth])
• db/ — Database schema definitions, migrations, and Drizzle configuration (drizzle.config.ts)

🎯 Current Status

In Progress — Core layout structure, responsive navigation, PostgreSQL database integration via Drizzle ORM, and full authentication (Auth.js v5) are implemented.