/gmap-vue

A wrapper component for consuming Google Maps API built on top of Vue. Fork of the popular vue-google-maps plugin.

Primary LanguageVue

GmapVue for Vue 3

Publish Documentation

A plugin for Vue that help you to manage Google Maps API on your Vue app.

Install

PNPM

pnpm add @gmap-vue/v3

NPM

npm install @gmap-vue/v3

Yarn

yarn add @gmap-vue/v3

Plugin dependencies

Name Version
vue npm version
@googlemaps/markerclusterer npm version
lodash.isEqual npm version
mitt npm version

The new documentation is not ready yet and we will landed it soon, until that please, refer to the source. On our code base we use typescript, it helps to follow the code along the repository and also we added comments in almost all functions and methods.

Fork of vue2-google-maps

This is a fork of the popular vue2-google-maps. As the author of the library no longer commits to maintain the project, we forked it to develop and maintain the project.

Workspaces

This project uses pnpm workspaces to manage the plugin and documentation site. You will find the version of this plugin for Vue 2 on packages/v2 folder, the version for Vue 3 on the packages/v3 folder and the documentation on packages/documentation folder.

  • Clone the repository and run

    • npm

      npm install
    • pnpm

      pnpm install
    • yarn

      yarn
  • To start the documentation site locally you can run the below command, it starts the documentation page on http://localhost:8080/

    pnpm run serve:docs

CONTRIBUTORS ARE WELCOME

If you have time to contribute to a rather frequently used library, feel free to make a PR!, but first please read our contributing guide.

What's urgently needed are:

  1. Better unit tests (we use Vitest).
  2. Better integration tests (we use Cypress)