{"id":26326377,"url":"https://github.com/charmingdc/bookquest","last_synced_at":"2025-03-15T19:38:33.214Z","repository":{"id":274529344,"uuid":"922718230","full_name":"Charmingdc/BookQuest","owner":"Charmingdc","description":"A book discovery web app to discover books of different genres and added user authentication for adding books 📚 to favourite and reading lists. 🚀 ( IN DEVELOPMENT )","archived":false,"fork":false,"pushed_at":"2025-03-04T13:16:49.000Z","size":1188,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-04T14:24:41.757Z","etag":null,"topics":["book-discovery","books","open-source","reactjs","typescript"],"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/Charmingdc.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":"2025-01-26T23:00:19.000Z","updated_at":"2025-03-04T13:16:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"4dcedf6f-413b-4fbd-ae79-c0c1f28c2215","html_url":"https://github.com/Charmingdc/BookQuest","commit_stats":null,"previous_names":["charmingdc/bookquest"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Charmingdc%2FBookQuest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Charmingdc%2FBookQuest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Charmingdc%2FBookQuest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Charmingdc%2FBookQuest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Charmingdc","download_url":"https://codeload.github.com/Charmingdc/BookQuest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243784057,"owners_count":20347409,"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":["book-discovery","books","open-source","reactjs","typescript"],"created_at":"2025-03-15T19:38:32.601Z","updated_at":"2025-03-15T19:38:33.208Z","avatar_url":"https://github.com/Charmingdc.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BookQuest  📚🤓\n\nWelcome to BookQuest, your personal book tracker and favorites list manager. BookQuest allows users to add books to their favorites collection, customize settings, and switch themes for a personalized experience. Users can sign up, log in, and manage their preferences securely.\n\n## Features 📌\n\n- Sign-up and login system: Users can sign up and log in securely to manage their account.\n\n- Add books to your favorites list: Keep track of the books you love or are interested in.\n\n- Theme Customization: Switch between light and dark themes to fit your style.\n\n- User Settings: Customize your preferences, including username and theme.\n\n- Quick Search: Easily find books using the Open Library API.\n\n- User-friendly interface: A clean, intuitive design to manage your favorite books.\n\n\n## Tech Stack ⚒️\n\n- Frontend: React, TypeScript\n\n- Backend: Open Library API (for fetching book data)\n\n- Authentication: Firebase (for user sign-up, login, and authorization)\n\n- State Management: React Hooks \u0026 Context Api\n\n- Build Tool: Vite\n\n- Styling: CSS (custom design)\n\n\n## Installation (For Developers) 👨🏼‍💻\n\nTo get started with BookQuest, follow these steps to run the app locally:\n\n1. Clone the repository:\n\n```bash\n git clone https://github.com/Charmingdc/BookQuest.git\n```\n\n\n2. Navigate into the project directory:\n\n``` bash\ncd BookQuest\n```\n\n3. Install the required dependencies:\n\n``` bash\nnpm install\n```\n\n4. Set up Firebase:\n\nGo to Firebase Console and create a new project.\n\n- Enable Firebase Authentication (email/password, Google, etc.).\n\n- Set up Firestore (optional for user settings).\n\n- Add your Firebase config to your app’s environment variables or directly into the firebase.ts file.\n\n\n5. Run the app:\n\n``` bash\nnpm run dev\n```\n\n\nYour app should now be running on `http://localhost:5173.`\n\n## Usage (For Developers) 💻\n\nAfter setting up and running the app locally:\n\n1. Sign up or log in to create and access your account securely.\n\n\n2. Search for books using the Open Library API.\n\n\n3. Add books to your favorites list.\n\n\n4. Change themes between light and dark modes from the settings.\n\n\n5. Update your user settings (username, theme preferences).\n\n\n\n## Contributing 👥\n\nContributions are always welcome! If you'd like to contribute, please follow these steps:\n\n1. Fork the repository.\n\n\n2. Create a new branch (git checkout -b feature-name).\n\n\n3. Make your changes and commit them (git commit -m 'Add feature').\n\n\n4. Push the branch to your fork (git push origin feature-name).\n\n\n5. Open a pull request to the main repository.\n\n\n\n## License 📑\n\nThis project is licensed under the GNUP License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharmingdc%2Fbookquest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharmingdc%2Fbookquest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharmingdc%2Fbookquest/lists"}