HelloJava

Aprenda Java de forma interativa em um app moderno feito em Flutter, com mapa de fases estilo liquid glass, exercícios gamificados, conquistas, laboratório e chat com IA (Gemini) para tirar dúvidas.

✨ Destaques

• Mapa de aprendizado com visual "glassmorphism" e transições suaves
• Estrada curva entre fases, com animação de toque antes de abrir cada lição
• Exercícios por seções com pontuação, XP e moedas
• Perfil com avatar, edição de nome e barra de progresso de nível
• Tela de Conquistas com desbloqueios baseados no seu progresso
• Tela de Laboratório para conteúdos extras e mini-experiências
• Chat integrado (Gemini) para aprender perguntando
• Modo desempenho automático no mobile (reduz blur e efeitos pesados)

🗂 Estrutura do projeto

lib/
	main.dart                    # Shell do app e navegação por PageView
	screens/
		map_screen.dart            # Mapa com estrada e nós (fases) em liquid glass
		exercise_screen.dart       # Exercícios e pontuação
		content_screen.dart        # Conteúdo em Markdown
		profile_screen.dart        # Perfil com XP/moedas e edição de nome
		achievements_screen.dart   # Conquistas (Star)
		labs_screen.dart           # Laboratório / extras (Extension)
		chat_screen.dart           # Chat com IA (Gemini)
	widgets/
		glass_nav_bar.dart         # Barra de navegação "liquid glass"

assets/
	icon.png                     # Logo do app
	content/*.md                 # Conteúdo das seções
	section-1-questions*.json    # Questões de exemplo
.env                           # Variáveis de ambiente (GEMINI_API_KEY)

✅ Pré‑requisitos

• Flutter SDK (canal estável)
• Dart SDK (vem junto com o Flutter)
• Android SDK / Xcode se for gerar builds mobile
• JDK 17 (para build Android)

🔧 Configuração

1. Instale as dependências do projeto:

flutter pub get

2. Crie um arquivo .env na raiz do projeto com sua chave da API do Gemini:

GEMINI_API_KEY=coloque_sua_chave_aqui

▶️ Rodando o app

Em um dispositivo/simulador já configurado:

flutter run

Desktop (opcional):

flutter config --enable-linux-desktop
flutter config --enable-windows-desktop
flutter run -d linux  # ou -d windows

🚀 Build de produção

Android (APK release):

# Requer JDK 17 e JAVA_HOME configurado
flutter build apk --release

Windows/Linux (desktop):

flutter build windows --release
flutter build linux --release

⚙️ Dicas de performance

• No mobile, o app ativa um "modo desempenho" que reduz blur e glows no mapa e nós das fases.
• Para avaliar fluidez real, use o modo Profile/Release:

flutter run --profile

• Opcional: faça warm‑up de shaders (SkSL) para reduzir stutters na primeira execução. Consulte a doc oficial do Flutter sobre SkSL warm‑up.

🔐 Variáveis de ambiente

O app usa flutter_dotenv para ler o arquivo .env:

• GEMINI_API_KEY: chave da API do Google Gemini usada pelo chat.

Mantenha esse arquivo fora de commits públicos.

🧩 Principais dependências

• shared_preferences: progresso (xp, moedas, melhores pontuações)
• flutter_markdown: renderização de conteúdo em Markdown
• google_generative_ai: integração com Gemini (chat)
• flutter_dotenv: variáveis de ambiente
• image_picker: suporte a imagem (quando aplicável)

📣 Contribuindo

Sugestões e PRs são bem-vindos! Abra uma issue descrevendo sua ideia ou bug encontrado.

---

Feito com Flutter 💙