{"id":19263286,"url":"https://github.com/adam014/ramble","last_synced_at":"2025-04-21T18:31:34.290Z","repository":{"id":207028632,"uuid":"713105563","full_name":"Adam014/ramble","owner":"Adam014","description":"Personal passport to the planet's price tags.","archived":false,"fork":false,"pushed_at":"2024-10-10T07:15:45.000Z","size":75533,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T15:11:38.674Z","etag":null,"topics":["javascript","jest","nextjs","react","supabase","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://ramble-blond.vercel.app","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/Adam014.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":"2023-11-01T21:07:54.000Z","updated_at":"2025-03-04T18:39:16.000Z","dependencies_parsed_at":"2023-11-19T21:26:48.941Z","dependency_job_id":"a0ff4960-df05-4295-a5af-cf12252eea17","html_url":"https://github.com/Adam014/ramble","commit_stats":{"total_commits":226,"total_committers":2,"mean_commits":113.0,"dds":"0.053097345132743334","last_synced_commit":"4cc54e4dc8951a68dead85f2f8d51b561e8f5721"},"previous_names":["adam014/nomadify","adam014/econiqq","adam014/ramble"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam014%2Framble","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam014%2Framble/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam014%2Framble/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adam014%2Framble/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adam014","download_url":"https://codeload.github.com/Adam014/ramble/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250110966,"owners_count":21376563,"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":["javascript","jest","nextjs","react","supabase","tailwindcss","typescript"],"created_at":"2024-11-09T19:35:30.437Z","updated_at":"2025-04-21T18:31:29.280Z","avatar_url":"https://github.com/Adam014.png","language":"TypeScript","readme":"\n# Ramble\n\nRamble is your personal passport to the planet's price tags. It's not just a web app; it's a whisperer for your wallet. Real-time data, tailor-made recommendations, and a community of kindred travelers make Ramble your go-to guide for worldly adventures without the financial fuss.\n## Badges\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n\n\u003c!--- ## Commits titles\n\nIf you are wondering WTF are these commits titles?!\n- I am creating commits titles based on what i am listening to, mostly music, because why not.\n\n--\u003e\n\n## Getting Started\n\n1. First, run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n# or\nbun dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\nYou can start editing the page by modifying `app/page.js`. The page auto-updates as you edit the file.\n\n## Run Locally\n\nClone the project\n\n```bash\n  git clone https://github.com/Adam014/Ramble.git\n```\n\nGo to the project directory\n\n```bash\n  cd ramble\n```\n\nInstall dependencies\n\n```bash\n  npm install\n```\n\nStart the server\n\n```bash\n  npm run dev\n```\n\n## Color Reference\n\n| Color             | Hex                                                                |\n| ----------------- | ------------------------------------------------------------------ |\n| Background_color | ![#00000](https://via.placeholder.com/10/0000?text=+) #000000 |\n| Button_color | ![#F13E51](https://via.placeholder.com/10/F13E51?text=+) #F13E51 |\n| Hover_color | ![#E08C9C](https://via.placeholder.com/10/E08C9C?text=+) #E08C9C |\n| Tag_color | ![#001a64](https://via.placeholder.com/10/001a64?text=+) #001a64 |\n\n\n## Environment Variables\n\nTo run this project, you will need to add the following environment variables to your .env file\n\nNEXT_PUBLIC_RAPIDAPID_KEY = your_RAPIDAPI_key \n\nNEXT_PUBLIC_SUPABASE_ANON_KEY = your_SUPABASE_key\n\nNEXT_PUBLIC_SUPABASE_APP_URL = your_SUPABASE_url\n\n\n## API Reference\n\n#### Get the details of the city\n\n```http\n  GET /map/${country}/${capital}\n```\n\n## Summary\nDefines three asynchronous functions to fetch city data from a Supabase database. The functions handle fetching data for a specific page number, a specific city, and all cities within a specific country.\n\n## Example Usage\n```js\nconst pageNumber = 1;\nconst citiesData = await fetchCitiesData(pageNumber);\nconsole.log(citiesData);\n\nconst country = 'USA';\nconst city = 'New York';\nconst cityData = await fetchCityData(country, city);\nconsole.log(cityData);\n\nconst citiesByCountry = await fetchCitiesByCountry(country);\nconsole.log(citiesByCountry);\n```\n\n## Code Analysis\n1. Inputs\n- pageNumber: A number representing the page of data to fetch.\n- country: A string representing the country name.\n- city: A string representing the city name.\n2. Flow\n- fetchCitiesData checks for existing data for a given page number and returns it sorted by rank.\n_ fetchCityData fetches data for a specific city and country.\n- fetchCitiesByCountry fetches all cities data for a specific country.\n3. Outputs\n- fetchCitiesData: Returns sorted city data for the given page number or null if an error occurs.\n- fetchCityData: Returns data for the specified city or null if not found or an error occurs.\n- fetchCitiesByCountry: Returns an array of cities data for the specified country or an empty array if not found or an error occurs.\n\n## Authors\n\n- [@kindast](https://www.github.com/kindast) - Fullstack Developer\n\n\n## Tech Stack\n\n**Client:** Next.js (both Typescript and Javascript for the map), TailwindCSS, Jest\n\n**Database:** Supabase \n\n## 🔗 Links\n[![linkedin](https://img.shields.io/badge/linkedin-0A66C2?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white)](https://www.linkedin.com/in/adam-stádník-271280218/)\n[![twitter](https://img.shields.io/badge/twitter-1DA1F2?style=for-the-badge\u0026logo=twitter\u0026logoColor=white)](https://twitter.com/kindastcs)\n\n\n## Contributing\n\nContributions are always welcome!\n\n\n## Support\n\nFor support, email adam.stadnik@seznam.cz or contact me via the web!\n\n\n## Feedback\n\nIf you have any feedback, please reach out to me at adam.stadnik@seznam.cz\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadam014%2Framble","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadam014%2Framble","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadam014%2Framble/lists"}