Skip to content

Antoniocutri/TaskNova

Repository files navigation

🚀 TaskNova

License: MIT Laravel React Docker

TaskNova is a full-stack web application built with Laravel and React, designed to manage tasks efficiently with a scalable and modern architecture.

📸 Preview

Dashboard
Main dashboard with task distribution overview

Task List
Task list with filters by status, priority, and title search


📋 Table of Contents


🧰 Tech Stack

  • Backend: Laravel (PHP)
  • Frontend: React (Vite)
  • Authentication: Laravel Fortify
  • Database: MySQL
  • Containerization: Docker & Docker Compose
  • CI/CD: GitHub Actions
  • Version Control: Git & GitHub

📦 Features

  • Task management system: Create, edit, delete, and organize tasks efficiently.
  • RESTful API: Robust backend powered by Laravel.
  • Modern UI: Reactive and fast frontend built with React.
  • Secure Authentication: Login & registration flow handled seamlessly using Laravel Fortify.
  • Containerized: Ready to run anywhere with a fully Dockerized environment.

🚀 Getting Started

Follow these steps to get a copy of the project up and running on your local machine.

Prerequisites

Make sure you have Docker and Git installed on your system.

1. Clone the repository & Environment Setup

git clone [https://github.com/Antoniocutri/TaskNova](https://github.com/Antoniocutri/TaskNova)
cd TaskNova

# Copy the example environment file
cp .env.example .env

(Configure your database credentials, App URL, and other variables in the .env file).

2. Run with Docker Compose (Recommended)

Build and spin up the application:

docker-compose up --build -d

3. Finalize Laravel Setup

(Run this if your Docker setup doesn't automatically generate the key and migrate the database):

docker-compose exec tasknova php artisan key:generate
docker-compose exec tasknova php artisan migrate

The application will now be available at: 👉 http://localhost:8080


🐳 Run with pre-built Docker Image

If you just want to run the application without cloning the source code, you can pull the pre-built image from Docker Hub:

docker pull antonio0307/tasknova:latest
docker run -p 8080:80 antonio0307/tasknova:latest

🔄 CI/CD

This project uses GitHub Actions to automate the build and deployment process. The pipeline is configured to:

  • Automatically build the Docker image on every push.
  • Push the latest image directly to Docker Hub.

📌 Future Improvements

  • Role-based access control
  • Task collaboration (shared tasks)
  • Notifications system
  • UI/UX improvements

👨‍💻 Author

Developed by Antonino Cutrì


📄 License

This project is open-source and available under the MIT License.

Releases

No releases published

Packages

 
 
 

Contributors