This is the frontend repository for the To-Do List application, developed as part of the Distributed Systems (C216) course project at Inatel. The application is built with React and Vite and can be run either locally or via Docker.
Before you begin, ensure you have the following tools installed on your machine:
- Git
- Node.js (which includes
npm) - Docker and Docker Compose (for the container option)
You can run this project in two ways: locally with Node.js or via Docker.
This method is ideal for developing and testing the application in real-time.
1. Clone the Repository
Open your terminal and clone the repository to your local machine:
git clone https://github.com/C216-Distribuid-System-Project/to-do-list-frontend.gitThen, navigate into the project folder:
cd to-do-list-frontend2. Install Dependencies
Inside the project folder, run the command below to install all the dependencies listed in package.json:
npm install3. Run the Application
After the installation is complete, start the Vite development server:
npm run devThe terminal will show the local address where the application is running (usually http://localhost:5173). Open this address in your browser to see the project in action.
If you wish to run it with Docker, please refer to the Docker execution documentation.
Este é o repositório frontend da aplicação To-Do List, desenvolvida como parte do projeto da disciplina de Sistemas Distribuídos (C216) no Inatel. A aplicação é construída com React e Vite e pode ser executada localmente ou via Docker.
Antes de começar, certifique-se de que você tem as seguintes ferramentas instaladas em sua máquina:
- Git
- Node.js (que inclui o
npm) - Docker e Docker Compose (para a opção com contêineres)
Você pode executar este projeto de duas maneiras: localmente com Node.js ou via Docker.
Este método é ideal para desenvolver e testar a aplicação em tempo real.
1. Clone o Repositório
Abra seu terminal e clone o repositório para sua máquina local:
git clone https://github.com/C216-Distribuid-System-Project/to-do-list-frontend.gitEm seguida, navegue para a pasta do projeto:
cd to-do-list-frontend2. Instale as Dependências
Dentro da pasta do projeto, execute o comando abaixo para instalar todas as dependências listadas no package.json:
npm install3. Execute a Aplicação
Após a instalação ser concluída, inicie o servidor de desenvolvimento do Vite:
npm run devO terminal mostrará o endereço local onde a aplicação está sendo executada (geralmente http://localhost:5173). Abra este endereço em seu navegador para ver o projeto em ação.
Se desejar executá-lo com Docker, consulte a documentação de execução com Docker.