Skip to content

Repository files navigation

✈️ Planner de Viagens entre Amigos

Um app mobile para planejar viagens em grupo, organizar atividades diárias, links importantes e convidados, desenvolvido com Expo, React Native e TypeScript.

Expo React Native TypeScript NativeWind

Planeje o destino, datas, convidados, atividades e links essenciais da sua próxima viagem, tudo em um só lugar.

📱 Demonstração

Planner - Tela 1 Planner - Tela 2 Planner - Tela 3 Planner - Tela 4

Convide seus amigos e planeje sua próxima viagem.

📌 Funcionalidades

🧭 Criação e gerenciamento de viagens

  • Criar nova viagem informando:
    • Destino
    • Data de ida e volta (selecionadas em um calendário)
  • Validação de dados:
    • Destino com tamanho mínimo
    • Obrigatoriedade de datas de início e fim
  • Salvar viagem no dispositivo para reabrir automaticamente depois
  • Atualizar viagem (destino e período) em uma tela própria
  • Remover viagem salva do dispositivo

👥 Convidados e convites

  • Adicionar e-mails de convidados para a viagem, com:
    • Validação de e-mail
    • Prevenção de e-mails duplicados
  • Listar convidados na tela de detalhes
  • Fluxo de confirmação de presença:
    • Tela específica onde o convidado informa nome e e-mail
    • Validação de e-mail antes de confirmar

📅 Atividades da viagem

  • Cadastro de atividades por dia:
    • Título da atividade
    • Data da atividade (dentro do período da viagem)
    • Horário da atividade
  • Visualização em lista seccionada por dia:
    • Dia e nome do dia da semana
    • Indicação se a atividade já aconteceu (data/horário no passado)
  • Interface pensada para uso contínuo durante a viagem

🔗 Links importantes

  • Cadastro de links relacionados à viagem:
    • Título (ex.: Reserva do hotel, Ingresso do parque, Passagens)
    • URL validada
  • Lista de links importantes visível para todos os convidados

🚀 Como Usar

1. Pré-requisitos

  • Node.js LTS instalado
  • npm ou yarn
  • Opcional: Expo Go instalado no celular ou emulador Android/iOS configurado

2. Clonar o repositório

git clone https://github.com/<seu-usuario>/planner.git

3. Instalar as dependências

cd planner
npm install

4. Executar o projeto

npm run start
  • O Expo abrirá um painel no navegador
  • Você poderá:
    • Ler o QR Code com o app Expo Go no celular, ou
    • Rodar em um emulador Android/iOS, ou
    • Abrir a versão web (opção Run on web no painel do Expo)

💻 Tecnologias

  • Expo (SDK 51)
  • React Native
  • TypeScript
  • Expo Router
  • React Navigation (via Expo Router)
  • NativeWind + Tailwind CSS
  • Dayjs (manipulação e formatação de datas)
  • Async Storage (persistência local)
  • Jest + jest-expo (testes)

🧱 Estrutura Principal

Algumas pastas importantes do projeto:

  • src/app: rotas e telas principais (criação de viagem, detalhes, atividades)
  • src/components: componentes reutilizáveis (inputs, botões, calendário, modal, loading, etc.)
  • src/server: camada de serviços para dados da viagem, links, participantes e atividades
  • src/storage: armazenamento local da viagem e dados do planejamento
  • src/styles: configurações de tema (cores, fontes, estilos globais)
  • src/utils: utilitários de calendário, validações e configurações de locale

🌟 Funcionalidades Principais

  • Interface intuitiva e focada em mobile
  • Planejamento completo da viagem: destino, período, convidados, atividades e links
  • Calendário interativo para seleção de datas
  • Validações amigáveis com mensagens em português
  • Design moderno usando NativeWind/Tailwind
  • Separação clara entre atividades e detalhes da viagem
  • Dados salvos no dispositivo para acessar sua viagem quando quiser

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

About

O Planner é um app de planejamento de viagens que com ele você conseguirá organizar uma viagem com amigos, marcar atividades e salvar links úteis. O Planner oferece uma experiência de usuário interativa e robusta, facilitando a colaboração e organizando todos os detalhes importantes da sua viagem com facilidade.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages