{"id":21818756,"url":"https://github.com/leonardonicola/readx","last_synced_at":"2026-04-13T13:02:08.794Z","repository":{"id":254458019,"uuid":"810014688","full_name":"leonardonicola/readx","owner":"leonardonicola","description":"Plataforma de trade de livros","archived":false,"fork":false,"pushed_at":"2025-04-10T23:31:52.000Z","size":633,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T00:26:47.708Z","etag":null,"topics":["clerk","docker","integration-testing","nextjs","prisma","react","shadcn-ui","soketi","tanstack-react-query","typescript","unit-testing"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leonardonicola.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-03T22:20:30.000Z","updated_at":"2025-04-10T23:31:55.000Z","dependencies_parsed_at":"2024-09-13T13:45:57.486Z","dependency_job_id":"107e76dd-36af-4f19-b9ac-7d03323bc8dc","html_url":"https://github.com/leonardonicola/readx","commit_stats":null,"previous_names":["leonardonicola/readx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/leonardonicola/readx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leonardonicola%2Freadx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leonardonicola%2Freadx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leonardonicola%2Freadx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leonardonicola%2Freadx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leonardonicola","download_url":"https://codeload.github.com/leonardonicola/readx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leonardonicola%2Freadx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31753551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clerk","docker","integration-testing","nextjs","prisma","react","shadcn-ui","soketi","tanstack-react-query","typescript","unit-testing"],"created_at":"2024-11-27T16:14:52.811Z","updated_at":"2026-04-13T13:02:08.780Z","avatar_url":"https://github.com/leonardonicola.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ReadX\n\n**ReadX** é uma plataforma que visa facilitar a busca de livros usados e a troca dos mesmos entre os usuários do sistema, permitindo que registrem os livros de sua posse e possibilitando outros usuários oferecer seus livros como moeda de troca.\n\n## Índice\n\n- [Visão Geral](#visão-geral)\n- [Funcionalidades](#funcionalidades)\n- [Tecnologias Utilizadas](#tecnologias-utilizadas)\n- [Instalação](#instalação)\n- [Uso](#uso)\n- [Contribuição](#contribuição)\n- [Licença](#licença)\n\n## Visão Geral\n\nReadX é uma aplicação web desenvolvida para conectar amantes de livros e facilitar a troca de livros entre eles. Com uma interface intuitiva, os usuários podem facilmente listar, buscar e negociar livros.\n\n## Funcionalidades\n\n- Cadastro e autenticação com email-senha ou Github\n- Registro de livros disponíveis para troca em sua _estante virtual_\n- Busca de livros por título, autor ou gênero\n- Sistema de mensagens para negociação de trocas (chat)\n- Perfil do usuário personalizável\n  \n## Tecnologias Utilizadas\n\n- [Next.js](https://nextjs.org/) - Meta framework componente core do sistema\n- [React](https://reactjs.org/) - Biblioteca para construção de interfaces de usuário\n- [Tailwind](https://tailwindcss.com/) - Framework CSS\n- [Prisma](https://www.prisma.io/) - ORM para banco de dados\n- [Clerk](https://clerk.com/) - Provedor de autenticação\n- [Terraform](https://www.terraform.io/) - Infrastructure as Code\n- [Bun](https://bun.sh/) - Runtime JS batteries included\n- [Docker](https://www.docker.com/) - Ferramenta para conteinerização\n\n## Instalação\n\nAntes de iniciar o projeto, tenha certeza que tem instalado em sua máquina:\n\n- Docker e Docker Compose\n- Bun\n- Terraform\n\nPara iniciar o projeto localmente, siga os passos abaixo:\n\n1. Clone o repositório:\n\n   ```bash\n   git clone https://github.com/leonardonicola/readx.git readx\n   ```\n\n2. Navegue até o diretório do projeto:\n\n   ```bash\n   cd readx\n   ```\n\n3. Instale as dependências:\n\n   ```bash\n   bun install\n   ```\n\n4. Crie um arquivo `.env` e adicione as variáveis de ambiente necessárias baseado no `.env.example`. É necessário uma conta no Clerk para ter acesso as chaves descritas no `.env`.\n\n5. Execute o servidor de desenvolvimento:\n\n   ```bash\n   bun dev\n   ```\n\n6. Acesse a aplicação em [http://localhost:3000](http://localhost:3000) em modo dev ou rode `docker compose --profile=dev up --build` e acesse [http://localhost](http://localhost) na porta 80\n\n## Uso\n\nApós a instalação, você pode acessar a plataforma e começar a registrar seus livros, buscar por outros livros e iniciar negociações com outros usuários.\n\n## Contribuição\n\nContribuições são bem-vindas! Para contribuir com o projeto:\n\n1. Faça um fork do repositório.\n2. Crie uma branch para sua feature (`git checkout -b feat/nome-da-feature`).\n3. Commit suas mudanças (`git commit -am 'Adiciona nova feature'`).\n4. Faça um push para a branch (`git push origin feat/nome-da-feature`).\n5. Abra um Pull Request.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleonardonicola%2Freadx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleonardonicola%2Freadx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleonardonicola%2Freadx/lists"}