README

Este projeto é o frontend de um aplicativo destinado a auxiliar na organização e distribuição de suprimentos, além de coordenar voluntários durante os alagamentos no Rio Grande do Sul. A aplicação visa conectar pessoas afetadas pelas enchentes com recursos essenciais e voluntários dispostos a ajudar.

Acesso à Aplicação

SOS Rio Grande do Sul Discord

Sobre o Projeto

O objetivo deste aplicativo é facilitar uma resposta rápida e eficiente em situações de emergência causadas por enchentes, promovendo a colaboração e o apoio mútuo entre a comunidade e organizações de ajuda.

Tecnologias Utilizadas

Este frontend foi desenvolvido utilizando as seguintes tecnologias:

  • React: Uma biblioteca JavaScript para construir interfaces de usuário.
  • Vite: Uma ferramenta de build com servidor de desenvolvimento.
  • Tailwind CSS: Framework CSS baseado em classes utilitárias.
  • shadcn/ui: Coleção de componentes reutilizáveis, baseado em Tailwind.

Para executar o frontend do aplicativo em seu ambiente local, siga os passos abaixo:

  1. Clone o repositório:
    git clone https://github.com/SOS-RS/frontend
    
  2. Entre no diretório do projeto:
    cd frontend
    
  3. Instale as dependências:
    npm install
    
  4. Inicie o servidor de desenvolvimento:
    npm run dev
    
    O app estará disponível em http://localhost:5173.

Contribuindo

Contribuições são muito bem-vindas! Se você tem interesse em ajudar a melhorar o app, por favor:

  1. Faça um fork do repositório.
  2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature).
  3. Faça seus commits (git commit -m 'Adicionando uma nova feature').
  4. Faça push para a branch (git push origin feature/MinhaFeature).
  5. Abra um Pull Request.

Agradecemos o seu interesse e apoio. Juntos, podemos fazer uma diferença significativa para as vítimas das enchentes no Rio Grande do Sul!