---
title: "Add a custom milkyway, stars and halo background to the globe | JavaScript maps SDK"
description: "Add a red Milky Way and halo to the globe."
---
> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.
# Add a custom milkyway, stars and halo background to the globe
Customize the map background to create a red Milky Way effect and create a _“toxic”_ halo around the Earth.
This option **only takes effect** when used in conjunction with the `projection: 'globe'` parameter.
In this example, we’ll use a Milky Way background, we will change the color of the stars to red and add a custom halo to create a toxic atmosphere effect.
### NPM module setup
```bash
npm install --save @maptiler/sdk
```
#### main.js
```js
import { Map, MapStyle, config } from '@maptiler/sdk';
import '@maptiler/sdk/dist/maptiler-sdk.css';
config.apiKey = 'YOUR_MAPTILER_API_KEY_HERE';
const map = new Map({
container: 'map', // container's id or the HTML element in which the SDK will render the map
style: MapStyle.SATELLITE,
projection: "globe",
center: [83, 30.8],
zoom: 0,
halo: {
scale: 1,
stops: [
[0.0, "rgba(77,51,15,1)"],
[0.5, "rgba(255,111,0,0.5)"],
[0.75, "rgba(250,0,0,0.0)"],
],
},
space: {
color: "#ff0000",
preset: "milkyway-bright",
}
});
map.on('load', () => {
map.flyTo({ //zoom out the map so that the background of the stars can be seen better.
zoom: -1,
essential: true
});
});
```
#### index.html
```html
Add a custom milkyway, stars and halo background to the globe | NPM example
```
#### style.css
```css
body {
margin: 0;
padding: 0;
}
#map {
position: absolute;
top: 0;
bottom: 0;
width: 100%;
}
```
### Basic JavaScript setup
```html
Globe with space background
```
## Learn more
For space customization and options, check the [CubemapLayerConstructorOptions](https://docs.maptiler.com/sdk-js/api/types/#CubemapLayerConstructorOptions).
## Related examples
### [Globe with custom halo](https://docs.maptiler.com/sdk-js/examples/halo-custom/)
Examples
Add a custom atmospheric glow effect around your globe.
### [Globe with initial space background](https://docs.maptiler.com/sdk-js/examples/space-simple/)
Examples
Add a deep space background environment to the globe.
### [Globe with milkyway and stars](https://docs.maptiler.com/sdk-js/examples/space-milkyway/)
Examples
Add a milkyway and stars background to the globe.
### [Projection control (globe)](https://docs.maptiler.com/sdk-js/examples/globe-control/)
Tutorials
Toggle between Mercator and globe projections using map controls.