📚 Book Flow

Plataforma avançada de criação literária com IA, oferecendo ferramentas para escrita, design de capas, geração de conteúdo e organização de projetos literários.

🚀 Tecnologias

• React 19 - Interface moderna e reativa
• TypeScript - Tipagem estática para maior segurança
• Vite - Build tool ultrarrápido
• Tailwind CSS - Estilização utilitária
• Google Gemini AI - Inteligência artificial generativa
• Hostinger - Backend e banco de dados MySQL

📋 Pré-requisitos

• Node.js 18 ou superior
• npm ou yarn
• Chave de API do Google Gemini
• Conta Google para autenticação (opcional)

🛠️ Instalação

# Clonar repositório
git clone [seu-repositorio]
cd BOOKFLOW

# Instalar dependências
npm install

# Configurar variáveis de ambiente
cp .env.example .env.local
# Edite .env.local com suas chaves

⚙️ Configuração

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

VITE_GOOGLE_API_KEY=sua_chave_google_aqui
VITE_GEMINI_API_KEY=sua_chave_gemini_aqui
VITE_DATABASE_URL=https://bookflow.shop/hostinger_api.php
VITE_GOOGLE_CLIENT_ID=seu_client_id_aqui

Como obter as chaves

1. Google Gemini API Key: Acesse Google AI Studio
2. Google Client ID: Configure no Google Cloud Console

🏃 Desenvolvimento

# Iniciar servidor de desenvolvimento
npm run dev

# Aplicação disponível em http://localhost:5173

O servidor de desenvolvimento inclui:

• Hot Module Replacement (HMR)
• TypeScript type checking
• Lazy loading de componentes
• Code splitting automático

🏗️ Build de Produção

# Gerar build otimizado
npm run build

# Preview do build localmente
npm run preview

O build de produção gera:

• Arquivos otimizados na pasta dist/
• Code splitting para melhor performance
• Assets comprimidos e otimizados
• Source maps para debugging

📦 Deploy

O projeto está configurado para deploy no Hostinger:

1. Execute npm run build para gerar a pasta dist/
2. Faça upload de todo o conteúdo da pasta dist/ para public_html/ no Hostinger
3. Configure as variáveis de ambiente no painel do Hostinger
4. Certifique-se de que o arquivo hostinger_api.php está configurado corretamente

Para mais detalhes sobre deploy, consulte a documentação específica.

📖 Funcionalidades

✍️ Editor de Texto Avançado

• Escrita com suporte a Markdown
• Versionamento de capítulos
• Histórico de alterações
• Backup automático

🎨 Design Studio

• Criação de capas com IA
• Geração de ilustrações
• Editor de imagens integrado
• Biblioteca de assets

📚 Gerenciamento de Projetos

• Organize múltiplos livros
• Sistema de capítulos e versões
• Metadados e tags
• Sincronização com nuvem

🤖 Assistente ATLAS

• IA conversacional para ajuda
• Sugestões de escrita
• Análise de conteúdo
• Geração de ideias

📊 Biblioteca Global

• Compartilhamento de assets
• Categorização inteligente
• Busca avançada
• Reutilização de conteúdo

🎯 Export Múltiplo

• EPUB (e-books)
• PDF (impressão)
• DOCX (Word)
• Pacote de monetização (com materiais de marketing)

🌐 PWA (Progressive Web App)

• Funciona offline
• Instalável no dispositivo
• Notificações push
• Sincronização em background

🎨 Temas

O Book Flow suporta tema claro e escuro, com alternância automática ou manual.

🔒 Segurança

• Autenticação via Google OAuth
• Chaves de API protegidas
• Content Security Policy (CSP) configurado
• Dados criptografados em trânsito

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

📝 Estrutura do Projeto

BOOKFLOW/
├── src/
│   ├── components/      # Componentes React
│   ├── services/        # Serviços e APIs
│   ├── contexts/        # Contextos React
│   ├── hooks/          # Hooks customizados
│   ├── utils/          # Utilitários
│   └── types/          # Definições TypeScript
├── public/             # Assets estáticos
└── dist/              # Build de produção

🐛 Reportar Bugs

Encontrou um bug? Por favor, abra uma issue com:

• Descrição detalhada do problema
• Passos para reproduzir
• Comportamento esperado vs. atual
• Screenshots (se aplicável)

📄 Licença

Este projeto está sob licença proprietária. Todos os direitos reservados.

👥 Autores

• Equipe Book Flow - Desenvolvimento e manutenção

🙏 Agradecimentos

• Google Gemini AI pela API de IA generativa
• Comunidade React pela excelente documentação
• Todos os contribuidores do projeto

---

Versão: 1.0.0
Última atualização: Janeiro 2026