{"id":28521711,"url":"https://github.com/revuz/chai-spotter","last_synced_at":"2026-05-20T05:10:38.977Z","repository":{"id":293845251,"uuid":"985256352","full_name":"ReVuz/Chai-Spotter","owner":"ReVuz","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-20T16:01:31.000Z","size":72,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T00:37:20.361Z","etag":null,"topics":["leafletjs","supabase","tea","vite"],"latest_commit_sha":null,"homepage":"https://chai-spotter.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/ReVuz.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,"zenodo":null}},"created_at":"2025-05-17T11:38:24.000Z","updated_at":"2025-05-20T16:01:35.000Z","dependencies_parsed_at":"2025-05-17T14:25:40.314Z","dependency_job_id":"d3d366d9-b8dd-4260-bf94-736400db0e86","html_url":"https://github.com/ReVuz/Chai-Spotter","commit_stats":null,"previous_names":["revuz/chaya-spotter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ReVuz/Chai-Spotter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReVuz%2FChai-Spotter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReVuz%2FChai-Spotter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReVuz%2FChai-Spotter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReVuz%2FChai-Spotter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ReVuz","download_url":"https://codeload.github.com/ReVuz/Chai-Spotter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReVuz%2FChai-Spotter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273403937,"owners_count":25099299,"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","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["leafletjs","supabase","tea","vite"],"created_at":"2025-06-09T08:13:26.702Z","updated_at":"2026-05-20T05:10:33.958Z","avatar_url":"https://github.com/ReVuz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chai Spotter\n\nDiscover finest tea stalls and chai spots with **Chai Spotter**!  \nA web app to explore, locate, and celebrate the unique chai culture across Kerala, India.\n\n\u003cimg src=\"https://img.icons8.com/color/96/000000/tea-cup.png\" alt=\"Chaya Spotter Logo\" width=\"48\" /\u003e\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Features](#features)\n- [Getting Started](#getting-started)\n- [Usage](#usage)\n- [Tech Stack](#tech-stack)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## Overview\n\n**Chai Spotter** helps tea lovers and travelers discover authentic tea stalls (\"chaya kada\") across the world.  \nFind the perfect spot for your next cup of chai using an interactive map and curated list of the best stalls.\n\n\u003e _\"Find your next tea spot ☕\"_\n\n---\n\n## Features\n\n- 🗺️ **Interactive Map**: Browse Kerala's tea stalls by location.\n- 🎲 **Surprise Me!**: Explore a random tea spot with a single click.\n- 🏆 **Featured Chai Spots**: See a curated list of must-visit stalls.\n- 🌗 **Dark Mode**: Seamless light/dark theme toggle.\n- ⭐ **Ratings \u0026 Specialties**: Discover each stall's unique offerings and user ratings.\n- 📱 **Responsive Design**: Works beautifully on desktop and mobile.\n\n---\n\n\n## Getting Started\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (v18+ recommended)\n- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/)\n\n### Installation\n\n```bash\ngit clone https://github.com/ReVuz/Chai-Spotter.git\ncd Chai-Spotter\nnpm install\n# or\nyarn install\n```\n\n### Running Locally\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\nThe app will be available at `http://localhost:5173` (or the port specified in your terminal).\n\n---\n\n## Usage\n\n- **Explore** the map to find tea stalls near you or across Kerala.\n- **Click** on a marker or a stall card to view details, specialties, and get Google Maps directions.\n- **Try \"Surprise Me!\"** for a random tea adventure.\n- **Switch** between light and dark mode using the toggle button.\n\n---\n\n## Tech Stack\n\n- **Frontend**: React + TypeScript\n- **Styling**: Tailwind CSS\n- **State Management**: React Hooks\n- **Map**: [React-Leaflet](https://react-leaflet.js.org/)\n- **Icons**: Lucide React, Icons8\n\n---\n\n## Data Model\n\nEach tea stall is defined as:\n\n```typescript\ninterface TeaStall {\n  id: number;\n  name: string;\n  location: string;\n  description: string;\n  specialties: string[];\n  position: [number, number]; // [latitude, longitude]\n  rating: number; // 1-5\n  imageUrl: string;\n}\n```\n\n---\n\n## Contributing\n\nPull requests are welcome!  \nIf you have suggestions for new tea spots, features, or bug fixes, please open an issue or PR.\n\n**To contribute:**\n1. Fork this repo\n2. Create your feature branch (`git checkout -b feature/your-feature`)\n3. Commit your changes (`git commit -am 'Add new feature'`)\n4. Push to the branch (`git push origin feature/your-feature`)\n5. Open a Pull Request\n\n---\n\n## License\n\n\u0026copy; 2025 Chai Spotter.  \n\n---\n\n\u003e _Discover the best tea experiences in Kerala with Chai Spotter!_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevuz%2Fchai-spotter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frevuz%2Fchai-spotter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevuz%2Fchai-spotter/lists"}