Visão do Produto
O que é o InkShelf
InkShelf é um leitor e organizador de quadrinhos, PDFs e EPUBs para Android. Ele transforma uma pasta de arquivos já existente no dispositivo do usuário — sem exigir reorganização, upload ou cadastro — em uma biblioteca navegável, com capas, progresso de leitura, favoritos, histórico e estatísticas.
Local é o padrão: sem conta, nuvem ou servidor, tudo o que o app sabe sobre a biblioteca vive no próprio aparelho. Opcionalmente, o usuário pode conectar servidores Komga/Kavita self-hosted que ele mesmo controla — nunca um serviço de nuvem do InkShelf, que não existe — e ler/sincronizar progresso e favoritos com eles lado a lado com as pastas locais (ver Fontes Remotas).
Para quem é
Para quem já tem um acervo pessoal de quadrinhos/PDFs/EPUBs organizado em pastas — baixado, digitalizado ou comprado avulso de fontes variadas — e quer uma forma agradável de navegar, continuar leituras de onde parou e redescobrir o que já tem, sem depender de um serviço externo para isso.
Proposta de valor central
- A pasta do usuário é a fonte da verdade. A estrutura da biblioteca no app espelha a estrutura real de pastas no armazenamento (ou do servidor remoto, se houver um conectado). Não há importação que duplica arquivos nem uma hierarquia própria do app para manter sincronizada.
- Local por padrão, sem depender de rede. O núcleo do app — pastas locais, leitura, progresso, favoritos — funciona inteiramente offline. Conectar um servidor Komga/Kavita é opt-in, nunca exigido.
- Continuar de onde parou é o caso de uso mais importante. Progresso de leitura, sugestões de próximo arquivo e a tela Início inteira são construídos em torno de retomar a leitura, não só de navegar um catálogo.
- Personalização visual como funcionalidade de primeira classe, não um extra: temas, tamanho de card, cantos de capa, animações e disposição das seções da Home são todos configuráveis.
Panorama de funcionalidades
| Área | O que cobre | Documentação |
|---|---|---|
| Biblioteca | Escaneamento de pastas, capas, filtros, ordenação, busca, favoritos, continuar lendo, histórico, estatísticas, notificações de leitura, fontes remotas (Komga/Kavita) | biblioteca/ |
| Leitores | Leitor de páginas (CBZ/CBR/PDF) e leitor EPUB dedicado, marcadores, zonas de toque, exportação de página | leitores/ |
| Interface | Telas principais, onboarding, temas e configurações | interface/ |
| Arquitetura | Modelo de dados, banco, cache e demais decisões técnicas | arquitetura/ |
Formatos suportados
CBZ, CBR (RAR4 e RAR5), CB7 (7-Zip), CBT (TAR), PDF, EPUB, além de ZIP/RAR/7Z/TAR genéricos tratados como arquivos de página. Metadados de ComicInfo.xml, quando presentes no arquivo, são lidos e aproveitados na busca e nas telas de detalhe.
Assinatura (Premium)
O app é gratuito para leitura local (pastas, EPUB, tema vermelho, favoritos, Tela Início). Uma assinatura opcional, InkShelf Premium, desbloqueia Modo Painel, Modo Livro, rolagem automática, os demais 7 temas de cor, conexão com servidores Komga/Kavita, histórico completo e estatísticas detalhadas — ver Assinatura.
O que o InkShelf não é
Delimitar o escopo é tão parte da visão de produto quanto descrever o que existe:
- Não é um serviço de descoberta ou aquisição de conteúdo — o app não baixa, vende ou indica onde obter quadrinhos.
- Não é um serviço de nuvem próprio nem faz sincronização entre dispositivos por conta própria — a sincronização que existe é sempre com um servidor Komga/Kavita self-hosted que o próprio usuário escolhe conectar, nunca uma infraestrutura do InkShelf.
- Não exige conta, login ou identidade de rede para o uso local — só é necessário se o usuário optar por conectar um servidor remoto.
Estado atual
App nativo Android (Kotlin + Jetpack Compose), em desenvolvimento ativo, versão 1.1.1, disponível na Google Play. Arquitetura e decisões técnicas em detalhe estão em 02 - Arquitetura Geral.