📱 Circle App

O Circle App é uma rede social open source que revoluciona como compartilhamos momentos. Uma plataforma autêntica e intuitiva para acompanhar amigos e família de forma leve e prazerosa.

✨ Diferenciais: Interface moderna • Foco na autenticidade • Open source • Feito no Brasil 🇧🇷

🧠 Features Principais

• 📸 Momentos - Criar e editar com vídeo e texto
• 📂 Memórias - Organizar momentos em coleções temáticas
• 💬 Social - Curtidas, comentários e interações
• 📱 Perfil - Galeria personalizada de memórias
• 🔔 Notificações - Push notifications em tempo real
• 🌍 Multilíngue - Português e Inglês

Tecnologias

Interface: React Native, TypeScript, React Navigation, Moti
Estado: Zustand, TanStack Query, AsyncStorage
Backend: Firebase, Authentication, Push Notifications
Testes: Vitest, Testing Library
Build: EAS, Xcode, Android Studio

🚀 Configuração do Ambiente

Requisitos

Básico: Node.js v18+ • npm/yarn • Git • Expo CLI
Development Build: EAS CLI • Conta Expo • Dispositivo/Emulador

npm install -g @expo/cli eas-cli

Configuração por Plataforma

🍎 iOS: Xcode + CocoaPods

# Instalar dependências
xcode-select --install
sudo gem install cocoapods

Requisitos: macOS • Xcode (App Store) • iOS Simulator

🤖 Android: Android Studio + SDK

# Configurar variáveis (adicionar ao ~/.bashrc)
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools

Requisitos: Android Studio • JDK 11+ • AVD configurado

Instalação

# Clone e instale
git clone https://github.com/Circle-Company/Circle-App.git
cd Circle-App
npm install

# iOS: Configure pods
npm run pod-install

# Configure EAS
npx expo login
eas build:configure

📱 Executando

Rodando Expo com Development Build (Não suporta o modo Expo GO)

# Criar build de desenvolvimento
eas build --platform all --profile development

# Executar
npm start
# Pressione 's' para Development Build mode

Comandos por Plataforma

npm run android    # Android
npm run ios        # iOS

Executando Testes

# Testes
npm test                    # Executar testes
npm run test:coverage       # Com coverage

# Debug
npx expo doctor             # Verificar problemas
npx expo start --clear      # Limpar cache

Problemas Comuns

🐛 Cache/Bundle issues

# Limpar caches e reinstalar
npx expo start --clear
rm -rf node_modules && npm install

Contribuindo

Procuramos desenvolvedores, designers e idealistas! 💜

Como Contribuir

1. Fork o projeto
2. Clone seu fork
3. Crie uma branch: git checkout -b minha-feature
4. Faça suas alterações
5. Abra um Pull Request

Diretrizes

📚 Documentação, 🧪 Testes, 🎨 Padrões, 💬 Commits descritivos

Reportando Bugs

1. Verifique se já existe uma issue similar
2. Crie uma nova issue com: descrição clara, passos para reproduzir, screenshots

Licença

CIRCLE LICENCE - Veja LICENSE para detalhes.

🇧🇷 Feito com ❤️ no Brasil

⭐ Dê uma estrela se este projeto te ajudou!