Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ayushsoni1010/mapsearchify

🫰🏻Snapchat-inspired world mapping with real-time tracking and lightning-fast search. Crafted with Algolia, MapboxGL.js, Vue InstantSearch, NuxtJS, and TypeScript.
https://github.com/ayushsoni1010/mapsearchify

algolia algolia-search algorithms location maboxgl map mapbox mapping nodejs people typescript vscode vue vue-instantsearch

Last synced: about 2 months ago
JSON representation

🫰🏻Snapchat-inspired world mapping with real-time tracking and lightning-fast search. Crafted with Algolia, MapboxGL.js, Vue InstantSearch, NuxtJS, and TypeScript.

Awesome Lists containing this project

README

        

MapSearchify πŸ—ΊοΈ


Real-time world mapping with lightning-fast search.


Tech Stack


Embark on a journey of real-time exploration. Explore, share, and connect with the world.

## Ahoy, Adventurers! 🌟

Welcome aboard the MapSearchify ship, where we set sail on a journey of innovation and discovery. Your presence during Hacktoberfest is like the wind in our sails, pushing us toward excellence.

We invite seasoned developers, visionary designers, and eager enthusiasts to join our crew. Chart a course for innovation, and let your insights and expertise be our guiding stars.

Come, shape the future of MapSearchify, and let's make waves together in the open-source community!

## Table of Contents πŸ“œ

- [Project Overview](#project-overview-)
- [Recommended IDE Setup](https://github.com/ayushsoni1010/mapsearchify#recommended-ide-setup-)
- [Type Support for `.vue` Imports in TypeScript](#type-support-for-vue-imports-in-typescript-)
- [Customize Configuration](#customize-configuration-)
- [Getting started](#getting-started-)
- [Contributing](#contributing-)
- [Issues](#issues-)
- [License](#license-)
- [Tech Stack Used](#tech-stack-used-)
- [Acknowledgments](#acknowledgments-)

## Project Overview πŸͺ™

MapSearchify is a unique world-mapping platform inspired by Snapchat. It offers real-time tracking and lightning-fast search. We've harnessed the power of Algolia, MapboxGL.js, Vue InstantSearch, NuxtJS, and TypeScript to create a dynamic and user-friendly mapping platform.

## Recommended IDE Setup βœ…

For a smooth development experience, we recommend the following IDE setup:

- [VSCode](https://code.visualstudio.com/)
- [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (disable Vetur)
- [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin)

## Type Support for `.vue` Imports in TypeScript πŸ”

TypeScript has its limitations when it comes to type information for `.vue` imports. We've replaced the `tsc` CLI with `vue-tsc` for type checking. To enable TypeScript's language service for `.vue` types in your code editor, you'll need the [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).

For faster performance, Volar offers a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669). To enable it and :

1. Disable the built-in TypeScript Extension:
- Run `Extensions: Show Built-in Extensions` from VSCode's command palette.
- Find `TypeScript and JavaScript Language Features`, right-click, and select `Disable (Workspace)`.

2. Reload the VSCode window by running `Developer: Reload Window` from the command palette.

## Customize Configuration πŸ›ƒ

For customizing the project's configuration, please refer to the [Vite Configuration Reference](https://vitejs.dev/config/).

## Getting started πŸš€
1. To run the development server with hot-reloading:
```sh
npm install
```

2. To run the development server with hot-reloading:
```sh
npm run dev
```

3. Type-check, compile, and minify for production
```sh
npm run build
```

4. Run unit tests using Vitest:

cd Run Unit Tests with [Vitest](https://vitest.dev/)
```sh
npm run test:unit
```

## Contributing 🀝

Contributions to MapSearchify are welcome! Feel free to open issues, submit pull requests, or provide feedback to help improve the project. Check out the [Contribution Guidelines](CONTRIBUTING.md) for more details.

## Issues πŸ›

If you encounter any issues or have suggestions, please report them in the [issue tracker](https://github.com/ayushsoni1010/mapsearchify/issues).

## License πŸ“œ

This project is licensed under the [MIT License](LICENSE). Feel free to use and modify the code to suit your needs.

## Tech Stack Used 🎨

- Nuxt.js
- TailwindCSS
- TypeScript
- MapboxGL.js
- Algolia
- Vue.js
- GitHub Actions

## Acknowledgments πŸ™

- Special thanks to the open-source community for their valuable contributions and tools that made this project possible.
- Inspired by the need for efficient content creation and sharing.