Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
.env
node_modules
/dist
.vscode
.vscode

package-lock.json

*log
59 changes: 59 additions & 0 deletions DEPLOY_CHECKLIST.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# ✅ Checklist de Deploy - Time for Code Frontend

## 🔒 Segurança

- [x] **Arquivo .env no .gitignore** - Variáveis sensíveis não serão commitadas
- [x] **Zero URLs hardcoded** - Todas as URLs da API usam variáveis de ambiente
- [x] **Configuração limpa** - Apenas exemplos genéricos nos arquivos de documentação

## 🚀 Configuração Vercel

- [x] **vercel.json** - Configurado para SPA (Single Page Application)
- [x] **package.json** - Scripts de build configurados corretamente
- [x] **Build testado** - `npm run build` funciona sem erros

## 🔧 Variáveis de Ambiente

### Para Deploy na Vercel:
1. Acesse o dashboard da Vercel
2. Vá em **Settings > Environment Variables**
3. Adicione:
- **Name**: `VITE_API_BASE_URL`
- **Value**: `https://sua-api-producao.com`
- **Environment**: Production (e Preview se desejar)

## 📁 Arquivos Importantes

- [x] `src/config/api.js` - Configuração centralizada da API
- [x] `vite.config.js` - Proxy configurado para desenvolvimento
- [x] `vercel.json` - Configuração para SPA
- [x] `package.json` - Scripts de build
- [x] `.gitignore` - Protege arquivos sensíveis
- [x] `README.md` - Documentação atualizada
- [x] `env.example` - Exemplo de configuração

## 🎯 Próximos Passos

1. **Commit das alterações:**
```bash
git add .
git commit -m "feat: configure environment variables and deploy setup"
```

2. **Push para GitHub:**
```bash
git push origin main
```

3. **Configurar Vercel:**
- Conectar repositório GitHub
- Configurar variável de ambiente
- Deploy automático ativado

## ✅ Status: PRONTO PARA DEPLOY

O projeto está configurado corretamente para:
- ✅ Deploy automático na Vercel
- ✅ Uso seguro de variáveis de ambiente
- ✅ Funcionamento em desenvolvimento e produção
- ✅ Zero informações sensíveis no repositório
60 changes: 60 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,3 +39,63 @@ O Time for Code está sendo desenvolvido para crianças e adolescentes que estã
- **Lucas [(zlucasftw)](https://github.com/zlucasftw)**: Desenvolvedor Backend
- **Layla [(laycsz)](https://github.com/laycsz)**: Desenvolvedora Frontend e Designer UI/UX
- **Arthur [(ArthurVenturi)](https://github.com/ArthurVenturi)**: Desenvolvedor Frontend

# Time for Code - Frontend

## Configuração de Variáveis de Ambiente

### Desenvolvimento Local

1. Copie o arquivo `env.example` para `.env`:
```bash
cp env.example .env
```

2. Configure a URL da API no arquivo `.env`:

**Para testar API de produção:**
```bash
VITE_API_BASE_URL=https://sua-api-producao.com
```

**Para API local:**
```bash
VITE_API_BASE_URL=http://localhost:3000
```

**Nota:** Em desenvolvimento, o sistema usa proxy do Vite automaticamente para APIs externas.

### Deploy na Vercel

1. Acesse o dashboard da Vercel
2. Vá para **Settings > Environment Variables**
3. Adicione a variável:
- **Name**: `VITE_API_BASE_URL`
- **Value**: `https://sua-api-producao.com`
- **Environment**: Production (e Preview se desejar)

### Vantagens da Configuração

✅ **Flexível**: Pode usar qualquer URL da API através de variáveis de ambiente
✅ **Seguro**: URLs não ficam hardcoded no código
✅ **Portável**: Funciona em qualquer ambiente (dev, staging, prod)
✅ **Manutenível**: Fácil de mudar URLs sem alterar código

### Estrutura de Arquivos

- `src/config/api.js` - Configuração centralizada da API
- `src/api/` - Endpoints da API
- `src/contexts/` - Contextos do React

## Scripts Disponíveis

- `npm run dev` - Inicia o servidor de desenvolvimento
- `npm run build` - Gera build de produção
- `npm run vercel-build` - Build específico para Vercel

## Tecnologias

- React 19
- Vite
- TanStack Router
- TanStack Query
55 changes: 55 additions & 0 deletions SETUP_PRODUCTION_TEST.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# Configuração para Testar API de Produção

## Passo 1: Configurar o arquivo .env

Edite o arquivo `.env` e configure a URL da API:

```bash
# Para testar API de produção
VITE_API_BASE_URL=https://sua-api-producao.com

# Para API local (alternativa)
# VITE_API_BASE_URL=http://localhost:3000
```

## Passo 2: Testar localmente

Execute o projeto:

```bash
npm run dev
```

O sistema vai automaticamente:
- Usar a URL configurada em `VITE_API_BASE_URL`
- Se for uma URL externa, usar o proxy do Vite para evitar CORS
- Redirecionar `/api/*` para a URL configurada

## Passo 3: Testar funcionalidades

1. Acesse: http://localhost:5175
2. Teste o cadastro de usuário
3. Teste o login
4. Verifique se não há erros de CORS

## Passo 4: Preparar para Deploy

Quando estiver funcionando, você pode:

1. Fazer commit das alterações
2. Fazer push para o GitHub
3. Na Vercel, configurar a variável de ambiente:
- **Name**: `VITE_API_BASE_URL`
- **Value**: `https://sua-api-producao.com`

## Como funciona:

- **Desenvolvimento**: Usa proxy do Vite (`/api/*` → `VITE_API_BASE_URL/*`)
- **Produção**: Usa URL direta (`VITE_API_BASE_URL/*`)

## Vantagens desta configuração:

✅ **Flexível**: Pode usar qualquer URL da API
✅ **Seguro**: URLs não ficam hardcoded no código
✅ **Portável**: Funciona em qualquer ambiente
✅ **Manutenível**: Fácil de mudar URLs sem alterar código
16 changes: 16 additions & 0 deletions env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Exemplo de variáveis de ambiente
# Copie este arquivo para .env e configure os valores

# URL base da API
# Para desenvolvimento local com API local:
VITE_API_BASE_URL=http://localhost:3000

# Para desenvolvimento local com API remota:
# VITE_API_BASE_URL=https://sua-api-producao.com

# Para produção, use a URL da sua API:
# VITE_API_BASE_URL=https://sua-api-producao.com

# NOTA: O sistema usa variáveis de ambiente para máxima flexibilidade
# Em desenvolvimento, usa proxy do Vite para APIs externas
# Em produção, usa a URL direta configurada na Vercel
16 changes: 7 additions & 9 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,21 +10,19 @@
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@100;200;300;400;500;600;700;800;900&display=swap" rel="stylesheet">
<link href="vendor/bootstrap/css/bootstrap.min.css" rel="stylesheet">
<link rel="stylesheet" href="assets/css/fontawesome.css">
<link rel="stylesheet" href="assets/css/index.css">
<link rel="stylesheet" href="assets/css/animated.css">
<link rel="stylesheet" href="assets/css/owl.css">
<link type="text/css" rel="stylesheet" href="/assets/css/index.css">
<link rel="shortcut icon" href="/img/logo.png" type="image/x-icon">
</head>

<body>
<div id="root">Não Renderizado</div>

<script type="module" src="src/components/App.jsx"></script>
<script type="module" src="assets/js/script.js"></script>
<script type="module" src="/src/components/App.jsx"></script>
<!-- <script type="module" src="/public/assets/js/script.js"></script>

<script src="assets/js/owl-carousel.js"></script>
<script src="assets/js/animation.js"></script>
<script src="assets/js/custom.js"></script>
<script type="module" src="/public/assets/js/owl-carousel.js"></script>
<script type="module" src="/public/assets/js/animation.js"></script>
<script type="module" src="/public/assets/js/custom.js"></script> -->
</body>

</html>
Loading