{"id":15673154,"url":"https://github.com/evavic44/currencee","last_synced_at":"2025-05-06T21:03:16.142Z","repository":{"id":39966403,"uuid":"507268767","full_name":"Evavic44/currencee","owner":"Evavic44","description":"🔄️ The world's most trusted, fast and secure currency converter","archived":false,"fork":false,"pushed_at":"2024-09-21T13:43:55.000Z","size":786,"stargazers_count":21,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T02:51:11.110Z","etag":null,"topics":["analytics","currency","currency-converter","currency-converter-api","exchange","finance","google-analytics","gsap","html5","javascript","netlify","sass","scss"],"latest_commit_sha":null,"homepage":"https://currencee.pro","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/Evavic44.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2022-06-25T09:31:38.000Z","updated_at":"2025-02-08T15:22:57.000Z","dependencies_parsed_at":"2024-08-07T23:43:13.600Z","dependency_job_id":"af4b4eca-fb1d-4999-8729-a6ac1d64706a","html_url":"https://github.com/Evavic44/currencee","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evavic44%2Fcurrencee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evavic44%2Fcurrencee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evavic44%2Fcurrencee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evavic44%2Fcurrencee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Evavic44","download_url":"https://codeload.github.com/Evavic44/currencee/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252769397,"owners_count":21801376,"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":["analytics","currency","currency-converter","currency-converter-api","exchange","finance","google-analytics","gsap","html5","javascript","netlify","sass","scss"],"created_at":"2024-10-03T15:37:41.262Z","updated_at":"2025-05-06T21:03:16.059Z","avatar_url":"https://github.com/Evavic44.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://curencee.pro\"\u003e\u003cimg src=\"public/logo.png\" alt=\"logo\" width=\"40px\"\u003e\u003c/a\u003e  \n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003ch1\u003eCurrencee\u003c/h1\u003e\n\u003cp\u003eThe World's Most Trusted, Fast and Secure Currency Converter\u003c/p\u003e \n\u003c/div\u003e\n\n\u003cimg src=\"https://res.cloudinary.com/victoreke/image/upload/v1722546085/currencee/cover.png\"\u003e\n\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.producthunt.com/posts/currencee?utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-currencee\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=351079\u0026theme=light\" alt=\"Currencee - Trusted | Product Hunt\" style=\"width: 190px; height: 54px;\" width=\"250\" height=\"54\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n## Run project locally\n\nThis project utilizes a simple nodejs express backend which is hosted on Vercel to hide the API credentials. To run the project locally, follow the steps below:\n\n- First generate your own API keys from [Currencybeacon](https://currencybeacon.com?ref=https://currencee.pro)\n- Fork and clone the project to your machine.\n- Rename `.env.example` in the `server` directory to `.env`\n- Insert your API keys\n- Run the commands below\n\n```\ncd server\nnpm install\nnpm start\n```\n\nThis should start the backend server on [localhost:5000](http://localhost:5000)\n\n## Vite App\n\nWith the server running, you can now run the converter locally,\n\n- Rename `.env.example` to `.env`\n- Set `VITE_API_URL` to the hosted backend URL (Only relevant for production)\n- Run the commands below\n\n```sh\nnpm install\nnpm run dev\n```\n\nNow you can visit [localhost:5173](http://localhost:5173) to see the project live.\n\n## Server Endpoints\n\n- Visit [localhost:5000/currency](http://localhost:5000/currency) to see the currency list\n- Visit [localhost:5000/convert](http://localhost:5000/convert) to perform a conversion\n\n\u003e [!IMPORTANT]\n\u003e The convert endpoint takes in three parameters, a base currency code `base`, a foreign currency code `foreign`, and the `amount` you would like to convert.\n\nExample endpoint\n\n```\nhttp://localhost:5000/convert?base=USD\u0026foreign=NGN\u0026amount=1\n```\n\nThis should return an object that contains the conversion details.\n\n\u003e If you notice any bugs or errors, kindly raise an issue to discuss it. Contributions are also welcome.\n\n## Attribution\n\nThe converter is powered by the [CurrencyBecacon API](https://currencybeacon.com), which supports over 161 commonly circulating world currencies listed [here](https://currencybeacon.com/supported-currencies). These cover 99% of all UN recognized states and territories.\n\nThe flags used are embedded using [Flagcdn](https://flagcdn.com/) which offers countries images based on their code.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevavic44%2Fcurrencee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevavic44%2Fcurrencee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevavic44%2Fcurrencee/lists"}