Skip to content

zenpai6996/FlowState-Frontend

Repository files navigation

FlowState

Streamline your workflow, boost productivity, and achieve that perfect flow state with our intuitive project management platform.

GitHub Repo

✨ Features

🎯 Core Functionality

Feature Description
🏠 Project Dashboard Get a bird's-eye view of all your projects
βœ… Task Management Create, assign, and track tasks with ease
πŸ‘₯ Team Collaboration Real-time updates and team communication
πŸ“Š Progress Tracking Visual progress indicators and completion metrics
⏰ Deadline Management Never miss important deadlines again

πŸ”₯ Advanced Features

Feature Description
πŸ“‹ Kanban Boards Visualize your workflow with drag-and-drop boards
⏱️ Time Tracking Monitor time spent on tasks and projects
πŸ“’ Activity Feed Stay updated with real-time project activities
πŸ”§ Custom Workflows Tailor the system to your team's needs

πŸ’Ž User Experience

Feature Description
πŸ“± Responsive Design Works seamlessly on desktop, tablet, and mobile
🎨 Multiple Themes Choose your preferred theme
🎯 Intuitive Interface Clean, modern design for maximum productivity
⚑ Fast Performance Optimized for speed and efficiency

πŸ› οΈ Tech Stack

  • Frontend Framework: React 18 with TypeScript
  • Styling: Tailwind CSS + Custom Components
  • Build Tool: Vite for lightning-fast development
  • State Management: React Context API / Redux Toolkit
  • Routing: React Router v6
  • HTTP Client: Axios for API communication
  • Form Handling: React Hook Form with Zod validation
  • Icons: Lucide React / Heroicons
  • Animations: Framer Motion

πŸ—οΈ Project Structure

FlowState-Frontend/
β”œβ”€β”€ .react-router/         # React Router cache
β”œβ”€β”€ app/                   # Main app directory
β”‚   β”œβ”€β”€ assets/           # Static assets (images, icons, etc.)
β”‚   β”œβ”€β”€ components/       # Reusable UI components
β”‚   β”œβ”€β”€ hooks/            # Custom React hooks
β”‚   β”œβ”€β”€ lib/              # Utility libraries
β”‚   β”œβ”€β”€ provider/         # Context providers
β”‚   β”œβ”€β”€ routes/           # Route definitions
β”‚   β”œβ”€β”€ types/            # TypeScript type definitions
β”‚   β”œβ”€β”€ welcome/          # Welcome page components
β”‚   β”œβ”€β”€ app.css          # Global app styles
β”‚   β”œβ”€β”€ root.tsx         # Root component
β”‚   └── routes.ts        # Route configuration
β”œβ”€β”€ public/              # Public static files
β”œβ”€β”€ .env                 # Environment variables
β”œβ”€β”€ .gitignore           # Git ignore file
β”œβ”€β”€ banner1.svg          # Project banner
β”œβ”€β”€ components.json      # Component configuration
β”œβ”€β”€ LICENSE              # License file
β”œβ”€β”€ package-lock.json    # Lock file
β”œβ”€β”€ package.json         # Package configuration
β”œβ”€β”€ react-router.config.ts # React Router configuration
β”œβ”€β”€ README.md            # Documentation
β”œβ”€β”€ tsconfig.json        # TypeScript configuration
└── vite.config.ts       # Vite build configuration

πŸ“Έ Screenshots

Landing Dashboard
FlowState Dashboard Project Overview
Workspace Projects
Task Board Team Workspace
Tasks Kanban
Analytics Dashboard App Settings

πŸš€ Quick Start

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/zenpai6996/FlowState-Frontend.git
    cd FlowState-Frontend
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Set up environment variables

    cp .env.example .env.local

    Update the .env.local file with your configuration:

    VITE_API_BASE_URL=http://localhost:5000/api
    VITE_APP_NAME=FlowState
  4. Start the development server

    npm run dev
    # or
    yarn dev
  5. Open your browser

    Navigate to http://localhost:5173 to see the application running.


🎨 Design System

FlowState follows a consistent design system with:

  • Colors: Modern palette with primary, secondary, and accent colors
  • Typography: Clear hierarchy with readable fonts
  • Spacing: Consistent spacing scale using Tailwind CSS
  • Components: Reusable components with consistent styling
  • Icons: Consistent icon set from Lucide React

πŸ“± Mobile Support

FlowState is fully responsive and provides an excellent experience across all devices:

  • Desktop: Full-featured interface with advanced functionality
  • Tablet: Optimized layout for touch interactions
  • Mobile: Streamlined interface with essential features

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


⭐ If you found this project helpful, please give it a star!

Crafted with πŸ’› by Souharda

About

Frontend for my project manager app

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •