{"id":19234013,"url":"https://github.com/freitasgouvea/best-sellers","last_synced_at":"2026-04-12T13:04:03.739Z","repository":{"id":182833671,"uuid":"663672506","full_name":"freitasgouvea/best-sellers","owner":"freitasgouvea","description":"User-friendly web application built with Next.js 13, React and Typescript","archived":false,"fork":false,"pushed_at":"2024-04-23T02:01:28.000Z","size":265,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-15T19:41:23.624Z","etag":null,"topics":["cd","ci","css","frontend","github-actions","html","jest","jest-tests","lint","nextjs","nextjs13","node","react","typescript","webapp"],"latest_commit_sha":null,"homepage":"https://freitasgouvea.github.io/best-sellers/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/freitasgouvea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2023-07-07T21:00:40.000Z","updated_at":"2024-04-23T02:01:32.000Z","dependencies_parsed_at":"2024-04-23T03:28:35.026Z","dependency_job_id":"a53d2270-ff5a-4154-a0af-463fec64bac8","html_url":"https://github.com/freitasgouvea/best-sellers","commit_stats":null,"previous_names":["freitasgouvea/best-sellers"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freitasgouvea%2Fbest-sellers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freitasgouvea%2Fbest-sellers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freitasgouvea%2Fbest-sellers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freitasgouvea%2Fbest-sellers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/freitasgouvea","download_url":"https://codeload.github.com/freitasgouvea/best-sellers/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240310872,"owners_count":19781341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cd","ci","css","frontend","github-actions","html","jest","jest-tests","lint","nextjs","nextjs13","node","react","typescript","webapp"],"created_at":"2024-11-09T16:12:34.206Z","updated_at":"2026-04-12T13:04:03.713Z","avatar_url":"https://github.com/freitasgouvea.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# best-sellers\n\nBest-Sellers is a user-friendly web application built with Next.js 13, React and Typescript.\n\n![screenshot-best-sellers](https://github.com/freitasgouvea/best-sellers/assets/46804396/b42959f3-b76a-4cb4-ad2a-6f75f79df54e)\n\n## Overview\n\nThis application is designed to provide book enthusiasts with seamless access to The New York Times Best Sellers lists and expore books across all categories.\n\nOne of the features of this application is its a calendar integration, allowing users to delve into all-time rankings for a specific date. By selecting a date on the calendar, users can explore the best-selling books of that particular day in the past.\n\nMoreover, this application serves as a convenient hub for book lovers, providing direct links to purchase the listed books. By simply clicking, users are seamlessly redirected to popular online retailers, ensuring a hassle-free experience when it comes to acquiring their desired reads.\n\nThis application is a tool for avid readers and literary enthusiasts seeking to stay up-to-date with the latest and greatest in the world of literature.\n\n## Technologies\n\n- [Node](https://nodejs.org/en/blog/release/v18.12.0) : `v18.12.0`\n- [NextJs](https://nextjs.org/) : `v13.4.9`\n- [React](https://react.dev/) : `v18.2.0`\n- [Typescript](https://www.typescriptlang.org/) : `v5.1.6`\n- [Jest](https://jestjs.io/) : `v29.6.1`\n\n## Installation\n\nClone the repository or download the project files:\n\n```bash\ngit clone https://github.com/freitasgouvea/best-sellers.git\n```\n\nThen navigate to the project directory:\n\n```bash\ncd best-sellers\n```\n\nAnd finally, install the project dependencies using npm:\n\n```bash\nnpm install\n```\n\n## Usage\n\nBefore run this project, create `.env.local` file on root and introduce your [New York Times API](https://developer.nytimes.com/) key in `NEXT_PUBLIC_NYT_API_KEY` envoirment variable:\n\n```\nNEXT_PUBLIC_NYT_API_KEY=//api-key\n```\n\n### Development\n\nRun the following command to start the development server:\n\n```bash\nnpm run dev\n```\n\nThe development server will start at [http://localhost:3000/](http://localhost:3000/)\n\n### Production\n\nRun the following command to generate an optimized version for production:\n\n```bash\nnpm run build\n```\n\nAnd then run  the following command to start the production server:\n\n```\nnpm run start\n```\n\nThe  production server can be accessed at [http://localhost:3000/](http://localhost:3000/)\n\n### Testing\n\nIf you want to execute unit tests, use the following command:\n\n```bash\nnpm test\n```\n\nThis will execute the test suite using Jest and the results will show in the console.\n\nIf you want to execute unit tests and see the coverage, use the following command: \n\n```bash\nnpm test:coverage\n```\n\nThe results with the code coverage will show in the console.\n\n## Contributing\n\nContributions to best-sellers are welcome! If you find any issues or want to enhance the project, feel free to submit a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreitasgouvea%2Fbest-sellers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreitasgouvea%2Fbest-sellers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreitasgouvea%2Fbest-sellers/lists"}