https://github.com/nshen/vite-plugin-cesium
⚡ Vite plugin for Cesium
https://github.com/nshen/vite-plugin-cesium
cesium cesium-demo cesiumjs gis vite-plugin vite-plugin-cesium
Last synced: 13 days ago
JSON representation
⚡ Vite plugin for Cesium
- Host: GitHub
- URL: https://github.com/nshen/vite-plugin-cesium
- Owner: nshen
- License: mit
- Created: 2021-03-03T05:44:56.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-11T14:50:33.000Z (7 months ago)
- Last Synced: 2025-03-31T02:14:39.843Z (20 days ago)
- Topics: cesium, cesium-demo, cesiumjs, gis, vite-plugin, vite-plugin-cesium
- Language: TypeScript
- Homepage:
- Size: 62.5 KB
- Stars: 249
- Watchers: 4
- Forks: 40
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-vite - vite-plugin-cesium - Integration with Cesium library. (Plugins / Framework-agnostic Plugins)
- awesome-vite - vite-plugin-cesium - Integration with Cesium library. (Plugins / Framework-agnostic Plugins)
README
# ⚡ vite-plugin-cesium
[](https://www.npmjs.com/package/vite-plugin-cesium)
[](https://www.npmjs.com/package/vite-plugin-cesium)
Easily set up a [`Cesium`] project in [`Vite`].
[`cesium`]: https://github.com/CesiumGS/cesium
[`vite`]: https://github.com/vitejs/vite
**update：** if you just wanna a scaffolding by using this plugin, try a simply command `yarn create cesium`, click [create-cesium](https://www.npmjs.com/package/create-cesium) for more info.
Chinese tutorial: [中文教程](https://zhuanlan.zhihu.com/p/354856692)
## Install
```bash
npm i cesium vite-plugin-cesium vite -D
# yarn add cesium vite-plugin-cesium vite -D
```
## Usage
add this plugin to `vite.config.js`
```js
import { defineConfig } from 'vite';
import cesium from 'vite-plugin-cesium';
export default defineConfig({
plugins: [cesium()]
});
```
add dev command to `package.json`
```json
"scripts": {
"dev": "vite",
"build": "vite build"
}
```
run:
`yarn dev`
## Options
**rebuildCesium**
- **Type :** `boolean`
- **Default :** `false`
Default copy min cesium file to dist. if `true` will rebuild cesium from source.
```js
import { defineConfig } from 'vite';
import cesium from 'vite-plugin-cesium';
export default defineConfig({
plugins: [
cesium({
rebuildCesium: true
})
]
});
```
## Demo
`src/index.js`
```js
import { Viewer } from 'cesium';
import './css/main.css';
const viewer = new Viewer('cesiumContainer');
```
> or if you like global Cesium object you can write as
```js
import * as Cesium from 'cesium';
const viewer = new Cesium.Viewer('cesiumContainer');
```
`index.html`
```html
cesium-vite
```
`src/css/main.css`
```css
html,
body,
#cesiumContainer {
width: 100%;
height: 100%;
margin: 0;
padding: 0;
overflow: hidden;
}
```
Add `dev` and `build` commands to `package.json`
```
"scripts": {
"dev": "vite",
"build": "vite build"
},
```
Run `yarn dev`
For full demo project please check [./demo](https://github.com/nshen/vite-plugin-cesium/tree/main/demo) folder.
##
## License
MIT