Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexlamper/geoname
GeoName is an interactive web application built with Next.js with the main functionality of allowing the users to guess geographical locations and flags.
https://github.com/alexlamper/geoname
Last synced: 14 days ago
JSON representation
GeoName is an interactive web application built with Next.js with the main functionality of allowing the users to guess geographical locations and flags.
- Host: GitHub
- URL: https://github.com/alexlamper/geoname
- Owner: AlexLamper
- License: mit
- Created: 2024-09-27T11:55:58.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-12-18T17:01:11.000Z (about 2 months ago)
- Last Synced: 2024-12-18T17:26:05.589Z (about 2 months ago)
- Language: TypeScript
- Homepage: https://geoname.site
- Size: 1.76 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# 🌍 GeoName
Welcome to **GeoName** – Your Online Geographical Placename Learning Platform.
---
## About GeoName
I created GeoName as my first 'startup' in the creation of 6 startups in 6 months. When is something a startup? Idk
GeoName is a web-based platform designed to help people learn about different geographical places, flags, and more. Whether you're a beginner or already have a lot of geographical knowledge, GeoName provides quizzes and learning resources to elevate your journey.
---
## 📜 Table of Contents
1. [Features](#features)
2. [Tech Stack](#tech-stack)
3. [Pages](#pages)
4. [API](#api)
5. [Contributing](#contributing)
6. [Support](#support)
7. [License](#license)
8. [Version](#version)
9. [FAQ](#faq)
10. [Contact](#contact)
---
## 🌟 Features
- **User Profiles**: Create and personalize your profile to showcase your progress and achievements.
- **Geographical Quizzes**: Test your knowledge of places and flags through fun, interactive quizzes.
- **Leaderboards**: Compete with other users, track your rankings, and celebrate your achievements.
- **Progress Tracking**: Monitor your quiz performance, achievements, and learning milestones.
- **Mobile-Friendly Design**: Learn on any device, anywhere.
- **Interactive Maps**: Discover the world with dynamic maps powered by Leaflet, making learning immersive and engaging.
---
## 💻 Tech Stack
GeoName uses modern technologies for optimal performance and user experience:
- **Next.js (TypeScript)**: Primary framework for building the app, providing server-side rendering, static site generation, and scalability.
- **Stripe**: Secure payment processing for future premium features.
- **Vercel**: Hosting and deployment platform optimized for Next.js applications.
- **ShadCN**: UI styling library for modular and accessible components, ensuring a cohesive design.
- **TailwindCSS**: Utility-first CSS framework for rapid, consistent styling.
- **Leaflet**: JavaScript library for interactive maps, allowing customizable layers and markers.
- **Overpass API**: Accesses OpenStreetMap's geographical data for quizzes and educational content.
- **Clerk**: Provides secure authentication with multi-method login support.
- **React-Icons**: Extensive icon library to improve visual consistency in the UI.
---
## 📄 Pages
- **Dashboard**: Overview of your progress, including completed quizzes, achievements, and leaderboard position.
- **Places**: Explore world locations with quizzes on cities, landmarks, and more.
- **Flags**: Test your knowledge of country flags.
- **Leaderboard**: See your ranking, motivating you to improve and climb the ranks.
- **Profile**: Customize your profile, view achievements, and track your learning journey.
- **About**: Learn more about GeoName's mission and goals.
- **Help**: Access FAQs and resources for any questions or support.
---
## 🌐 API
GeoName uses the **Overpass API** for retrieving up-to-date geographical data, such as place names and boundaries, directly from OpenStreetMap. For more information on available data, check out the [Overpass API documentation](https://wiki.openstreetmap.org/wiki/Overpass_API).
---
## 🤝 Contributing
GeoName welcomes contributions! Here’s how you can contribute:
1. **Fork the repository** and create a new branch.
2. **Make your changes** and add descriptive commit messages.
3. **Submit a pull request** detailing your improvements or fixes.
Every contribution helps make GeoName better for everyone! 🎉
---
## ❤️ Support
If you’d like to support my work, sharing GeoName with others or contributing to development would be greatly appreciated!
---
## 📄 License
This project is licensed under the [MIT License](LICENSE), allowing for reuse and modification with attribution.
---
## 📌 Version
Current Version: **v1.0**
---
## ❓ FAQ
**Q: Is GeoName free to use?**
A: Yes! GeoName is free for everyone. Certain premium features may be added in the future.
**Q: What data sources are used for geographical information?**
A: GeoName uses OpenStreetMap data through the Overpass API for accurate, up-to-date information.
**Q: How do I report a bug or suggest a feature?**
A: Please open an issue on our GitHub repository with details of your suggestion or bug report.
---
## 📬 Contact
Got questions, feedback, or just want to say hi? Reach out at [[email protected]](mailto:[email protected]).
Thanks for checking out **GeoName**! 🌍