{"id":25916166,"url":"https://github.com/princepal9120/taskflow","last_synced_at":"2026-05-11T07:03:57.268Z","repository":{"id":276977376,"uuid":"930907052","full_name":"princepal9120/TaskFlow","owner":"princepal9120","description":"TaskFlow is an advanced task management application that enhances productivity by providing a visual workflow for tracking task progress. Utilizing Material UI for a sleek UI and React Flow for an interactive progress visualization, TaskFlow ensures an intuitive and efficient task management experience","archived":false,"fork":false,"pushed_at":"2025-02-11T13:11:04.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-03T12:19:29.036Z","etag":null,"topics":["fastapi","material-ui","postgresql"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/princepal9120.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T12:09:59.000Z","updated_at":"2025-02-12T06:40:20.000Z","dependencies_parsed_at":"2025-02-11T13:42:45.841Z","dependency_job_id":"85f5b9b2-9bb0-4285-bb1a-829be813955b","html_url":"https://github.com/princepal9120/TaskFlow","commit_stats":null,"previous_names":["princepal9120/taskflow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/princepal9120/TaskFlow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/princepal9120%2FTaskFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/princepal9120%2FTaskFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/princepal9120%2FTaskFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/princepal9120%2FTaskFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/princepal9120","download_url":"https://codeload.github.com/princepal9120/TaskFlow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/princepal9120%2FTaskFlow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275798438,"owners_count":25530258,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-18T02:00:09.552Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","material-ui","postgresql"],"created_at":"2025-03-03T12:19:32.927Z","updated_at":"2025-09-18T16:49:06.120Z","avatar_url":"https://github.com/princepal9120.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TaskFlow\n\nTaskFlow is a task management application built with a modern tech stack. It provides a user-friendly interface to manage tasks in both list and flow views. The backend is powered by FastAPI and PostgreSQL, while the frontend is built with React, TypeScript, and Vite.\n\n## Tech Stack\n\n### Frontend\n- **React**: A JavaScript library for building user interfaces.\n- **TypeScript**: A typed superset of JavaScript that compiles to plain JavaScript.\n- **Vite**: A build tool that aims to provide a faster and leaner development experience for modern web projects.\n- **Material-UI**: A popular React UI framework for building responsive and accessible user interfaces.\n- **React Flow**: A library for building node-based editors and diagrams.\n\n### Backend\n- **FastAPI**: A modern, fast (high-performance) web framework for building APIs with Python 3.6+ based on standard Python type hints.\n- **SQLAlchemy**: The Python SQL toolkit and Object-Relational Mapping (ORM) library.\n- **PostgreSQL**: A powerful, open-source object-relational database system.\n\n## Setup\n\n\n### Prerequisites\n- Node.js (v14 or higher)\n- Python (v3.8 or higher)\n- PostgreSQL\n## Getting Started\n \n **Clone the repository**:\n   ```bash\n   git clone https://github.com/your-username/your-repo-name.git\n   cd your-repo-name  \n   ```\n\n\n### Frontend Setup\nNavigate to the `frontend` directory:\n   ```sh\n   cd frontend\n   npm install\n   npm run dev\n   ```\n\n### Backend Setup\nNavigate to the `backend` directory:\n   ```sh\n   cd backend\n   python -m venv venv\n   source venv/bin/activate\n   # On Windows, use `venv\\Scripts\\activate`\n   pip install -r requirements.txt\n   ```\n\n### Database Setup\nSet up the PostgreSQL database and update the `DATABASE_URL` in the `.env` file.\n\n### Start the FastAPI Server\n  ```sh\n  uvicorn main:app --reload\n  ```\n  ### Access the application:\n\n**Frontend**: Open http://localhost:3000 in your browser.\n\n**Backend API docs**: Open http://localhost:8000/docs to explore the API endpoints.\n  \n# How to Work with This Project\n\nThis project is divided into two main parts: the **frontend** and the **backend**. Below is a guide to help you understand the structure, technologies used, and how to work with the project.\n\n---\n\n## Frontend\n\nThe frontend is built with **React** and **TypeScript**. Here are the key details:\n\n- **Main Entry Point**: `src/main.tsx`\n- **Main Component**: `src/App.tsx`  \n  This component handles the task management logic and UI.\n- **UI Libraries**:\n  - **Material-UI**: Used for building UI components.\n  - **React Flow**: Used for rendering the flow view.\n\n---\n\n## Backend\n\nThe backend is built with **FastAPI** and **SQLAlchemy**. Here are the key details:\n\n- **Main Entry Point**: `main.py`\n- **API**: The backend provides RESTful API endpoints for managing tasks.\n- **Database**: The database models are defined using **SQLAlchemy ORM**.\n\n---\n\n## Why This Tech Stack?\n\n### React and TypeScript\n- **React**: Provides a component-based architecture that makes it easy to build and maintain complex user interfaces.\n- **TypeScript**: Adds static typing to JavaScript, which helps catch errors early and improves code quality.\n\n### Vite\n- **Vite** offers a fast and lean development experience with instant hot module replacement (HMR) and optimized build performance.\n\n### FastAPI\n- **FastAPI**: Provides high-performance and automatic interactive API documentation, making it easy to build and test APIs.\n\n### PostgreSQL\n- **PostgreSQL**: A robust and reliable database system that supports advanced data types and performance optimization features.  \n  It was chosen over MySQL and MongoDB due to its strong ACID compliance, advanced indexing capabilities, and better support for complex queries and data integrity constraints.\n\n---\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprincepal9120%2Ftaskflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprincepal9120%2Ftaskflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprincepal9120%2Ftaskflow/lists"}