Skip to content

Welcome to Simple TO-DO, a lightweight task management application built with Laravel(backend) and React( frontend). This project demonstrates how to combine a Laravel API with a React UI for creating, reading, updating, and deleting tasks in a simple and clean way.

License

Notifications You must be signed in to change notification settings

Kavithma-Thushal/simple-to-do-coveragex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

45 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌟 Simple TO-DO (Laravel + React) 🌟

Welcome to Simple TO-DO, a lightweight task management application built with Laravel(backend) and React( frontend). This project demonstrates how to combine a Laravel API with a React UI for creating, reading, updating, and deleting tasks in a simple and clean way.

πŸ› οΈ Tech Stack

πŸ”₯ Frontend

βœ… React
βœ… Vite
βœ… Typescript
βœ… Tailwind CSS

πŸ”₯ Backend

βœ… Laravel
βœ… PHPUnit
βœ… MySQL

πŸš€ Features

βœ… Add new tasks
βœ… View all tasks
βœ… Mark tasks as completed
βœ… Persistent storage with MySQL
βœ… Clean and modern UI with Tailwind

▢️ How to Run the Project

  1. Clone the repository:
    git clone https://github.com/Kavithma-Thushal/simple-to-do-coveragex.git
    
  2. Install dependencies:
  • Frontend
    cd frontend
    npm install
    
  • Backend
    cd backend
    composer install
    
  1. Open Docker Desktop Software on your machine.

  2. Open a terminal in the Project Root directory.

  3. Build and start the containers:

    docker-compose up --build
    
  4. Open your browser and access:

    http://localhost:5173
    
  5. βœ… You’re all set! Add, view, and manage your tasks easily!

🐬 How to Access the MySQL Database (Docker) - Optional

  1. Open a terminal in the Project Root directory.

  2. Run this command to enter the MySQL container:

    docker exec -it db mysql -u root -p
    
  3. Enter the password:

    1234
    
  4. Select the database:

    USE to-do;
    
  5. View tasks table:

    SELECT * FROM tasks;
    

πŸ§ͺ How to test

  • Frontend
    cd frontend
    npx vitest run
    
  • Backend
    cd backend
    php artisan test
    

πŸ”— API Endpoints (Laravel)

βœ… POST /api/task/add
βœ… GET /api/task/getAll
βœ… PATCH /api/task/complete

πŸ“Έ Screenshots

Frontend-Light

Frontend-Dark

MySQL DB

Tests

πŸ“¬ Get in Touch

Got any bugs, issues, or need help understanding the code? Feel free to reach out!

πŸ“§ kavithmathushal9007@gmail.com

This project is licensed under the GNU License

Β© 2025 All Rights Reserved | Designed by Kavithma Thushal

About

Welcome to Simple TO-DO, a lightweight task management application built with Laravel(backend) and React( frontend). This project demonstrates how to combine a Laravel API with a React UI for creating, reading, updating, and deleting tasks in a simple and clean way.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published