https://github.com/galembeck/wagon-delivery
This repository contains the project structure of delivery website developed for the integrative project of the Web Development discipline of the Computer Engineering course at PUC-Campinas university.
https://github.com/galembeck/wagon-delivery
clerk clerkauth nextjs nextjs14 react reactjs shadcn shadcn-ui shadcnui tailwind tailwind-css tailwindcss zod
Last synced: 7 months ago
JSON representation
This repository contains the project structure of delivery website developed for the integrative project of the Web Development discipline of the Computer Engineering course at PUC-Campinas university.
- Host: GitHub
- URL: https://github.com/galembeck/wagon-delivery
- Owner: galembeck
- Created: 2024-09-28T14:56:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-27T13:46:15.000Z (11 months ago)
- Last Synced: 2025-02-01T12:22:37.548Z (9 months ago)
- Topics: clerk, clerkauth, nextjs, nextjs14, react, reactjs, shadcn, shadcn-ui, shadcnui, tailwind, tailwind-css, tailwindcss, zod
- Language: TypeScript
- Homepage: https://wagon-delivery.vercel.app
- Size: 12 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚚 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](#-wagondelivery)
- [📋 Sumário](#-sumário)
- [✨ Recursos](#-recursos)
- [🧠 Tecnologias](#-tecnologias)
- [🛠️ Pré-requisitos](#️-pré-requisitos)
- [🚀 Instalação](#-instalação)
- [🏃♂️ Utilização](#️-utilização)
- [📂 Estrutura de Arquivos](#-estrutura-de-arquivos)
- [🤝 Colaboradores](#-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
- [x] Next.js
- [x] TailwindCSS
- [x] Local storage
- [x] TypeScript
- [x] Context API
- [x] React-hook-form
- [x] Form validations with Zod
- [x] 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:
```bash
git clone https://github.com/galembeck/wagon-delivery.git
cd wagon-delivery
```
2. Instale as dependências do projeto:
```bash
# 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:
```bash
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
```
---
## 🏃♂️ Utilização
Inicie o servidor de desenvolvimento para rodar o projeto localmente:
```bash
# Usando Yarn
yarn run dev
# Usando npm
npm run dev
```
> O projeto estará disponível em **http://localhost:3000**
---
## 📂 Estrutura de Arquivos
```bash
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.