🚚 WagonDelivery

Plataforma de entrega digital fácil, rápida e moderna, construída com as melhores tecnologias de front-end!

WagonDelivery é um projeto desenvolvido durante as aulas de Desenvolvimento WEB do curso de graduação de Engenharia de Computação da Universidade Pontifícia Católica de Campinas (PUC-Campinas), que visa otimizar a logística de entrega digital. Utilizando o poder de React, Next.js e TailwindCSS, a plataforma fornece uma experiência de usuário elegante, funcional e escalável. Clerk é utilizado para gerenciar autenticação e controle de acesso, enquanto Shadcn auxilia com componentes de UI estilizados e personalizados.

Acesse o projeto/código do GitHub em https://github.com/galembeck/wagon-delivery Acesse o preview em https://wagon-delivery.vercel.app

---

📋 Sumário

• 🚚 WagonDelivery
  • 📋 Sumário
  • ✨ Recursos
  • 🧠 Tecnologias
  • 🛠️ Pré-requisitos
  • 🚀 Instalação
  • 🏃‍♂️ Utilização
  • 📂 Estrutura de Arquivos
  • 🤝 Colaboradores

---

✨ Recursos

• Interface Moderna: Experiência de usuário rica e interativa com React e Next.js
• Autenticação Segura: Controle de autenticação e permissões com Clerk
• Estilos Dinâmicos e Responsivos: Estilização elegante e adaptável usando TailwindCSS
• Componentes Personalizáveis: Biblioteca de UI com Shadcn para componentes visuais fáceis de customizar
• Desempenho e SEO Otimizados: Com o poder do Next.js para SSR (Server Side Rendering) e SSG (Static Site Generation)

---

🧠 Tecnologias

• Next.js
• TailwindCSS
• Local storage
• TypeScript
• Context API
• React-hook-form
• Form validations with Zod
• Clerk Authenticator

---

🛠️ Pré-requisitos

Antes de começar, certifique-se de ter as seguintes ferramentas instaladas:

• Node.js versão 14.x ou superior
• Yarn ou npm para gerenciar pacotes

---

🚀 Instalação

1. Clone o repositório:

   git clone https://github.com/galembeck/wagon-delivery.git
   cd wagon-delivery

2. Instale as dependências do projeto:

    # Usando Yarn
    yarn install
   
    # Ou usando npm
    npm install

3. Configure as variáveis de ambiente necessárias:

   • Crie um arquivo .env na raiz do projeto com as seguintes variáveis:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=

---

🏃‍♂️ Utilização

Inicie o servidor de desenvolvimento para rodar o projeto localmente:

# Usando Yarn
yarn run dev

# Usando npm
npm run dev

O projeto estará disponível em http://localhost:3000

---

📂 Estrutura de Arquivos

wagon-delivery/
├── public/               # Assets públicos
│   ├── assets/             
│       ├── coffee/       # Imagens e ícones (coffee)
│       ├── food/         # Imagens e ícones (food)
│   ├── icons/            # Ícones globais
├── src/                  # Código-fonte
│   ├── app/              # Conteúdo de páginas
│   ├── components/       # Componentes reutilizáveis
│   ├── config/           # Arquivo de configuração
│   ├── constants/        # Constantes reutilizáveis
│   ├── contexts/         # Arquivos de contextos
│   ├── hooks/            # Hooks customizados
│   ├── lib/              # Configuração (shadcn-ui)
│   ├── styles/           # Estilos globais
│   ├── types/            # Interfaces reutilizáveis
│   ├── utils/            # Utilitários e helpers
│   ├── middleware.ts     # Arquivo de configuração (Clerk)
├── .env                  # Arquivo variáveis de ambiente
└── README.md             # Documentação do projeto

---

🤝 Colaboradores

Pedro Galembeck

Arthur Camilotti

João Santos

Murilo Prado

---

Made with 💜 by PUC-Campinas students.