Baseado no design proposto pelo @eliezer-castro, removi algumas features temporariamente, para tornar mais acessível e de rápida implementação. Nosso objetivo é criar uma versão mínima viável (MVP) do projeto, mantendo a estrutura existente e começando a estabelecer uma identidade visual mais única e marcante.

Gostaria de expressar minha gratidão novamente ao @eliezer-castro por sua contribuição ao projeto.

Link do MVP no Figma

Seria uma boa ideia adicionar um modo claro e escuro.

Eu tenho bastante dificuldade pra ler em modo claro e isso me incômoda bastante, além de que seria uma boa ferramenta de acessibilidade também.

Eu posso abrir um PR implementando essa ideia se concordarem com a ideia.

Eu tenho uma sugestão que é de alguma forma, ter um botão para exportar o container do versículo como um print. O app Glorify faz algo semelhante e eu conheço várias pessoas que gostam de compartilhar as mensagens de forma rápida. Ter a opção de abrir o site, clicar num botão e já ter a imagem pronta para compartilhar no WhatsApp com alguém é uma feature muito útil.

Sabemos que, para o Verse evoluir, precisamo de uma marca mais definida.

Desde o início do projeto, o design é simples mas funcional - sinceramente não me preocupei muito com o estético - porém necessita de uma identidade.

E como Deus é perfeito, no momento exato apareceu nosso amigo eliezercastro que criou um design incrível e compartilhou comigo em uma postagem no TabNews.

Se liga no design:

Eu achei SENSACIONAL! Se quiser conferir em mais detalhes, aqui está o link do projeto no Figma.

Abri esta issue para discutirmos sobre o design, o logotipo e qualquer aspecto estético relacionado ao projeto.

Tem alguma ideia para melhorar esse design? Ou talvez tenha outra sugestão? Fique à vontade para comentar, todas as contribuições são bem-vindas!

Quanto mais opiniões, melhor! Vamos dar ao Verse uma nova identidade.

Olá a todos,

Resolvi abrir essa issue para abordar uma melhoria crucial no projeto, relacionada aos versículos - vulgo elemento core da aplicação - que são consumidos da API fornecida pelo @omarciovsena.

Atualmente, utilizamos a rota /api/verses/nvi/pt/random para selecionar aleatoriamente um versículo bíblico. No entanto, essa abordagem apresenta uma lacuna significativa: a falta de contexto nos versículos selecionados.

Frequentemente, um único versículo isolado não transmite uma mensagem clara ou inspiradora, pois pode fazer parte de um pensamento mais amplo que se estende por vários versículos ou ser parte de um diálogo maior. Por exemplo:

"Então Abisai, filho de Zeruia, disse ao rei: Por que esse cão morto amaldiçoa o rei meu senhor? Permite que eu lhe corte a cabeça."

Inclusive foi o versículo de hoje, dia 20/03/2023:

Como podemos perceber, versículos sem contexto adequado não proporcionam reflexão ou inspiração aos usuários, a não ser que você já conheça aquele trecho.

Essa falta de contexto decorre da natureza aleatória da rota utilizada. Não podemos prever o tipo de mensagem que será entregue ao usuário, nem tão pouco se terá relevância ou sentido.

Além disso, gostaria de esclarecer que isso não é uma crítica a API. Afinal, a seleção de versículos aleatórios é justamente isso, aleatória! Essa aleatoriedade é, na verdade, um sinal de que a API está funcionando conforme esperado.

A questão é como podemos lidar com isso?

Possível solução 🤓

Para abordar essa problemática, proponho a criação de um arquivo JSON contendo versículos pré-selecionados. Essa abordagem permitirá uma seleção mais criteriosa de versículos, garantindo que cada mensagem tenha um contexto significativo. Além disso, abrirá uma grande oportunidade para a comunidade contribuir, adicionando novos versículos ao arquivo.

Felizmente, a API também fornece uma rota para buscar versículos específicos, o que simplifica nossa implementação.

Vejo 2 pontos importantes a serem considerados para garantir o funcionamento correto desta solução:

• Evitar repetições de versículos no arquivo, pois isso aumentaria a probabilidade de versículos serem selecionados várias vezes.
• Padronizar o formato do arquivo e a identificação dos versículos. (Acho que um JSON Schema resolve)

Isso é o que eu consegui enxergar! Encorajo todos a compartilharem suas ideias e perspectivas sobre como poderíamos lidar com essa questão, ou até mesmo completar a minha proposta.

A diversidade de opiniões e experiências é fundamental para encontrarmos a melhor solução possível.

A tabela a seguir lista as abreviações dos livros da Bíblia, acompanhadas por suas correspondências.
Esta lista pode ser útil para referência rápida ao querer adicionar um versículo ao projeto.

Antigo Testamento

Novo Testamento

"Confie no Senhor de todo o seu coração e não se apóie em seu próprio entendimento"
Provérbios 3:5

Metas de versículos 🎯

• 1 versículo adicionado;
• 10 versículos adicionados;
• 50 versículos adicionados;
• 100 versículos adicionados;
• 🥉 200 versículos adicionados;
• 🥈 300 versículos adicionados;
• 🥇 365 versículos adicionados;

Nem sempre toda contribuição em um projeto da comunidade precisa ser extremamente complexa, na verdade ela precisa apenas agregar valor!

Dito isso, precisamos criar uma lista de 365 versículos pré-selecionados!
Sim, poderíamos fazer um web scrapping, pedir ao GPT, ou utilizar qualquer outra estratégia. Mas, o que poderia ser mais gratificante e único do que a contribuição direta dos membros da comunidade?

Por este motivo, escolhemos utilizar um simples arquivo JSON com referências a versículos que você pode ajudar a selecionar! Além disso esse será o repertório de possíveis versículos a impactar os usuários do Verse.

Cada versículo que você adiciona não apenas enriquece a aplicação, mas também pode inspirar e atingir positivamente os usuários.

Como você pode contribuir?

Atualmente temos uma branch chamada feat/add-365-verses.

É nesta branch que vamos concentrar todas as contribuições de versículos, pelo menos os 365 iniciais para colocarmos em produção!

Para adicionar um versículo e fazer sua primeira contribuição, siga estes passos:

1. Faça um fork do projeto.

O fork é uma cópia do projeto que você pode modificar conforme desejar, e depois pode sincronizar com as modificações das outras pessoas do repositório.

2. Clone o seu fork para sua máquina usando Git ou GitHub CLI.
3. Adicione os versículos na branch feat/add-365-verses do seu fork, através do arquivo verses.json localizado em src/verses.json.

Por exemplo, se eu quero adicionar Provérbios‬ ‭5‬:‭23, ficaria desta maneira:

{
	"abbrev": "pv",
	"chapter": "5",
	"verse": "23"
}

abbrev: abreviação do livro, temos uma lista das abreviações aqui para ajudar;
chapter: capítulo do livro;
number: número do versículo;

4. Após adicionar o versículo, faça um commit.
   Nesse projeto, estamos utilizando o Conventional Commits.
   Exemplo de commit: feat: add verse proverbios 5:23

5. Quanto tiver terminado todas as suas contribuições, faça um pull request (PR) das modificações para a branch feat/add-365-verses do repositório oficial.

Sugestão

Acho que seria interessante adicionar CONTRIBUTING.md na raiz do projeto e linkar ele no Readme principal.

Nesse arquivo ficaria um "tutorial" de como contribuir com o projeto, seja apenas adicionando versículos ou com código mesmo.

Fica mais fácil de contribuir e consequentemente pode atrair mais pessoas, mesmo as que nunca tiveram a primeira experiência com Open Source.

Além de ajudar pessoas mais desatentes (como eu) a não abrir PR na main (exatamente oq eu fiz), explicar que é pra abrir na develop.

Ali deveria mostrar 21:59:56, mas os minutos vem 60

Um versículo a cada 24 horas

Olá a todos,

Estou iniciando um novo projeto open source chamado Verse e gostaria de compartilhar com vocês o propósito e a motivação por trás dele.

O Verse é uma aplicação simples que oferece um novo versículo bíblico a cada 24 horas. Ele visa ser uma fonte diária de inspiração e reflexão, compartilhando a sabedoria da palavra de Deus com o mundo!

O que buscamos construir juntos?

Além de levar uma mensagem que pode mudar o dia de uma pessoa, uma das razões para a construção dessa aplicação é abrir oportunidades para que as pessoas façam suas primeiras contribuições em projetos reais da comunidade.

Muitas vezes, podemos acreditar que contribuir para algo exige a realização de tarefas extremamente complexas. No entanto, este projeto visa desafiar esse pensamento e servir como um ponto de partida acessível para quem deseja começar a contribuir.

Deixe sua marca neste projeto!

Para começarmos com o pé direito e impulsionarmos o projeto desde já! Deixe um 'oi' ou compartilhe o que você espera deste projeto nos comentários. Assim você já está começando a deixar sua marca no Verse!

Estamos abertos a todas as sugestões e ideias. Se você tem algo em mente, fique à vontade para comentar aqui.