{"id":22217062,"url":"https://github.com/johndev19/convy","last_synced_at":"2025-07-27T14:31:04.657Z","repository":{"id":263415923,"uuid":"890330315","full_name":"JohnDev19/Convy","owner":"JohnDev19","description":"Convy is a React-based application for handling some unit conversions. It supports some categories like Length, Area, Volume, Temperature, Speed, Time, Mass, Digital Storage, Energy, Pressure, and Currency. Users can input values, select units and obtain results easily.","archived":false,"fork":false,"pushed_at":"2024-11-18T12:04:19.000Z","size":104,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-18T12:57:58.049Z","etag":null,"topics":["calculator","converter","css","javascript","react"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JohnDev19.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,"publiccode":null,"codemeta":null}},"created_at":"2024-11-18T11:43:21.000Z","updated_at":"2024-11-18T12:28:41.000Z","dependencies_parsed_at":"2024-11-18T13:11:24.484Z","dependency_job_id":null,"html_url":"https://github.com/JohnDev19/Convy","commit_stats":null,"previous_names":["johndev19/convy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FConvy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FConvy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FConvy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnDev19%2FConvy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnDev19","download_url":"https://codeload.github.com/JohnDev19/Convy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227810310,"owners_count":17823176,"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":["calculator","converter","css","javascript","react"],"created_at":"2024-12-02T22:14:55.262Z","updated_at":"2024-12-02T22:15:00.676Z","avatar_url":"https://github.com/JohnDev19.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Convy - Online Converter Calculator\n\n## About\n\n**Convy** is a React-based application for handling some unit conversions. It supports some categories like Length, Area, Volume, Temperature, Speed, Time, Mass, Digital Storage, Energy, Pressure, and Currency. Users can input values, select units and obtain results easily. This also provides a simple chart visualization for each conversion.\n\n![Demo](img/IMG_20241118_195744.jpg)\n\n![Demo](img/IMG_20241118_195818.jpg)\n\n---\n\n## Features\n\n- **Unit Conversion**: Converts between multiple units across different categories.\n- **Categories Supported**:\n  - Length\n  - Area\n  - Volume\n  - Temperature\n  - Speed\n  - Time\n  - Mass\n  - Digital Storage\n  - Energy\n  - Pressure\n  - Currency\n- **Interactive Chart**: Displays a chart visualizing the conversion results.\n- **Responsive Design**: Adjusts sidebar visibility based on screen size.\n- **Real-Time Currency Rates**: Fetches the latest exchange rates from an API.\n\n---\n\n## Usage\n\n1. Select a conversion category (e.g., Length, Area, Currency) from the sidebar.\n2. Input the value to be converted.\n3. Choose the **From Unit** and **To Unit** using the dropdowns.\n4. View the result along with a visual representation in the chart.\n\n---\n\n## Conversion Logic\n\n- For non-currency units:\n  - Converts to a base unit.\n  - Converts from the base unit to the target unit.\n- For temperature:\n  - Applies specific conversion formulas (e.g., Celsius to Fahrenheit).\n- For currency:\n  - Fetches exchange rates and calculates conversions.\n\n---\n\n### Key States:\n- `activeConverter`: Tracks the selected conversion category.\n- `inputValue`, `fromUnit`, `toUnit`: Manages user input and unit selections.\n- `result`: Displays the conversion result.\n- `currencies`, `exchangeRates`: Stores currency data fetched from the API.\n\n---\n\n## Future Enhancements\n\n- **Dark Mode**: Add support for dark mode for better usability in low-light conditions.\n- **Unit Suggestions**: Automatically suggest popular unit conversions based on user input.\n- **Save History**: Allow users to save and revisit past conversions.\n- **Localization**: Support for multiple languages.\n\n---\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. \n\n---\n\n## Acknowledgments\n\n- **React**: For the dynamic and efficient UI components.\n- **Open Exchange Rates API**: For providing real-time currency data.\n- **Chart.js**: For chart visualizations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohndev19%2Fconvy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohndev19%2Fconvy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohndev19%2Fconvy/lists"}