{"id":26282923,"url":"https://github.com/martindios/greendots","last_synced_at":"2025-08-18T08:05:50.224Z","repository":{"id":282295098,"uuid":"946554985","full_name":"martindios/GreenDots","owner":"martindios","description":"Mobile app to discover and evaluate businesses based on their sustainability impact.","archived":false,"fork":false,"pushed_at":"2025-04-02T15:30:30.000Z","size":114420,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T15:35:10.279Z","etag":null,"topics":["eco-friendly","green-tech","kotlin","mobile-app","postgres","sdgs","spring-boot","sustainability"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/martindios.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":"2025-03-11T10:21:25.000Z","updated_at":"2025-04-02T15:30:34.000Z","dependencies_parsed_at":"2025-03-14T12:31:44.874Z","dependency_job_id":null,"html_url":"https://github.com/martindios/GreenDots","commit_stats":null,"previous_names":["martindios/sustainablemaps","martindios/greendots"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/martindios/GreenDots","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martindios%2FGreenDots","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martindios%2FGreenDots/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martindios%2FGreenDots/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martindios%2FGreenDots/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/martindios","download_url":"https://codeload.github.com/martindios/GreenDots/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martindios%2FGreenDots/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270962391,"owners_count":24675965,"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-08-18T02:00:08.743Z","response_time":89,"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":["eco-friendly","green-tech","kotlin","mobile-app","postgres","sdgs","spring-boot","sustainability"],"created_at":"2025-03-14T17:16:01.272Z","updated_at":"2025-08-18T08:05:50.214Z","avatar_url":"https://github.com/martindios.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌍 Green Dots\n\n## 🚀 Impact-thon ETSE - USC\n\nWelcome to **Green Dots**, a mobile application designed to empower users to explore businesses that contribute to a more sustainable and responsible world. As society moves forward towards eco-friendly and ethical practices, Sustainable Maps provides a platform to discover, review, and evaluate businesses based on their adherence to Sustainable Development Goals (SDGs).\n\n![GreenDots example picture](GreenDots_readme_picture.jpg)\n\n\u003e [!CAUTION]\n\u003e This application is a demo and is not intended for production use.\n\u003e Please note that it is not safe for storing confidential or sensitive data, such as real user passwords.\n\u003e Use this application for testing and development purposes only. Thank you for your understanding!\n\n---\n\n## 📌 How Does It Work?\n\n1. **Sign in** – Create an account, and start exploring your area and submitting your opinions.\n2. **Explore \u0026 Search** – Choose an area to explore and search for businesses that interest you.\n3. **Evaluate Businesses** – Check sustainability statistics related to the SDGs for each business.\n4. **Share Your Thoughts** – Leave reviews and contribute valuable feedback to help others make informed choices.\n5. **Enjoy Dynamic Navigation** – Experience seamless transitions and an intuitive interface.\n6. **Customize Your Experience** – Switch between **day mode** and **night mode** for better usability or choose the language you are the more comfortable with.\n\n---\n\n## 🏗 Architecture\n\nSustainable Maps is built with a robust and modern tech stack:\n\n- **Backend:** Server developed in Java using the Spring Boot framework, which allows building a robust REST API.\n- **Database:** PostgreSQL for efficient data management, in a lightweight Docker container.\n- **Frontend:** Kotlin for a smooth and responsive mobile application experience.\n\n### 💡 Architecture Advantages\n\nSeparating application logic into modular components facilitates future development, allowing for the creation of desktop versions, apps for the Apple ecosystem, or even a website. This modularity not only improves code maintainability but also opens the door to future integrations and expansions.\n\n---\n\n## ⚙️ Deployment\n\nTo run the application locally, we will follow these steps:\n\n```bash\n#Clone the repository\ngit clone https://github.com/martindios/GreenDots\n#Start Docker with the database\ncd GreenDots/database/Docker\ndocker compose up -d\n#Build and run the Java server\ncd ../Server/\n./gradlew build\n./gradlew bootRun\n```\n\n---\n\n## 🔥 Key Features\n\n✅ **User Profiles** – Personalize your account with your name and a nickname.  \n✅ **Location-Based Search** – Find and explore businesses with ease.  \n✅ **Sustainability Insights** – Gain visibility into how businesses align with SDGs.  \n✅ **Smooth Navigation** – Enjoy beautiful animations and transitions.  \n✅ **Light/Dark Mode** – Adjust the theme to match your preferences.  \n✅ **Community Reviews** – Read and leave opinions to help others make better choices.  \n\n---\n\n## 🌍 Open Source and Accessibility\n\nAs an open source application, the API can be released or shared, allowing other projects to access our application's data without restrictions. This can be especially beneficial for university studies or companies interested in acquiring collected information, fostering collaboration and knowledge sharing.\n\n---\n\n## 📜 License\n\nSustainable Maps is released under the **Apache License 2.0**. This means you are free to use, modify, and distribute the project as long as you adhere to the license terms. For more details, check the `LICENSE` section of this repository.\n\n---\n\n## 💡 Get Involved!\n\nWe welcome contributions from developers, designers, and sustainability enthusiasts! Feel free to fork the repository, submit issues, or create pull requests.\n\n### 🌱 Together, let’s build a greener future! 🌍\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartindios%2Fgreendots","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmartindios%2Fgreendots","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartindios%2Fgreendots/lists"}