{"id":22732,"library":"vite-plugin-mars3d","title":"vite-plugin-mars3d","description":"A Vite plugin for integrating Mars3D (a 3D GIS platform built on Cesium) into Vite projects. Current stable version 4.2.2, updated 2024-08-13. Provides seamless integration by handling Vite-specific configurations, copy assets, and optional CDN usage. Enables faster HMR and optimized builds for Mars3D applications. Key differentiators: easy setup, TypeScript support, and compatibility with latest Vite versions (v4+).","status":"active","version":"4.2.2","language":"javascript","source_language":"en","source_url":"https://github.com/marsgis/vite-plugin-mars3d","tags":["javascript","marsgis","mars3d","cesium","vite","vite-plugin","gis","3dgis","webgis","typescript"],"install":[{"cmd":"npm install vite-plugin-mars3d","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-mars3d","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-mars3d","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Plugin runs as a Vite plugin, requires Vite v2+.","package":"vite","optional":false}],"imports":[{"note":"Package is ESM-only; no CommonJS export.","wrong":"const mars3dPlugin = require('vite-plugin-mars3d')","symbol":"mars3dPlugin","correct":"import mars3dPlugin from 'vite-plugin-mars3d'"},{"note":"defineConfig is from Vite, not this plugin.","wrong":"import { defineConfig } from 'vite-plugin-mars3d'","symbol":"defineConfig","correct":"import { defineConfig } from 'vite'"},{"note":"Plugin type is from Vite, not this plugin.","wrong":"import { Plugin } from 'vite-plugin-mars3d'","symbol":"type Plugin","correct":"import { Plugin } from 'vite'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite';\nimport mars3dPlugin from 'vite-plugin-mars3d';\n\nexport default defineConfig({\n  plugins: [mars3dPlugin()],\n});","lang":"typescript","description":"Basic setup of vite-plugin-mars3d in Vite config, enabling Mars3D integration."},"warnings":[{"fix":"Upgrade to Node.js 16+ and Vite 4+.","message":"v4.0+ drops support for Node.js 14 and Vite 3.x.","severity":"breaking","affected_versions":">=4.0"},{"fix":"Replace 'useCDN: true' with 'cdn: true'.","message":"Option 'useCDN' replaced by 'cdn' in v4.0.","severity":"deprecated","affected_versions":">=4.0"},{"fix":"Ensure mars3dPlugin() is the first element in plugins array.","message":"Plugin must be listed first in plugins array to work correctly.","severity":"gotcha","affected_versions":">=1.0"},{"fix":"Add to tsconfig.json: \"types\": [\"vite-plugin-mars3d\"]","message":"When using TypeScript, ensure 'vite-plugin-mars3d' is included in tsconfig 'types' array for intellisense.","severity":"gotcha","affected_versions":">=3.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run npm install vite-plugin-mars3d --save-dev","cause":"Missing package installation.","error":"Error: Cannot find module 'vite-plugin-mars3d'"},{"fix":"Use import mars3dPlugin from 'vite-plugin-mars3d'","cause":"Incorrect import: using CommonJS require instead of ESM import.","error":"TypeError: mars3dPlugin is not a function"},{"fix":"Ensure mars3d is installed: npm install mars3d","cause":"Mars3D dependency not installed or incorrectly resolved.","error":"[plugin:vite-plugin-mars3d] Failed to resolve import \"mars3d\" from \"xxx\""}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}