The client-side application for Manage Your Flow, a professional task and project tracking system. This project focuses on a seamless user experience, complex state management, and enterprise-level UI components.
Note
This frontend communicates with a NestJS API. For the best experience, ensure the backend is active. Initial loading might take a moment due to free-tier hosting on Render
- Forms: Robust project and task creation using
React Hook FormandZodvalidation. - Optimistic Updates: Using
TanStack Queryto provide an instant UI response while syncing with the server. - Authentication Flow: Secure JWT and protected routes.
- Theming & UI: Built with
Shadcn/uiandTailwind CSSfor a consistent, accessible, and responsive design.
- Core: React + TypeScript + Vite
- UI Components: Shadcn/ui (Radix UI under the hood)
- Styling: Tailwind CSS
- Server State: TanStack Query (React Query) — for caching, synchronization, and error handling.
- Form Management: React Hook Form + Zod.
- Icons: Lucide React.
The project is built using Feature-Sliced Design (FSD). This architectural methodology allows for a clear separation of concerns, making the codebase scalable, easy to test, and maintain.
app/- Application logic: providers, global styles, and routing setup.pages/- Composition layer that assembles widgets into full pageswidgets/- Large self-contained components that combine featuresfeatures/- User-facing actions that carry business valueentities/- Business logic and data models for core objects:- auth: Authentication state and profile logic
- project: Project-specific data, types, and hooks
- task: Task-related state management and components
shared/- Reusable, project infrastructure:ui/: Design system based on Shadcn/uiapi/: Axios instance, interceptors, and base configurationslib/: Utils, shared hooks, and context providers