webamp/packages/webamp-docs/docs/02_install.md
Jordan Eldredge 91e6bd3902 Add docs site
2025-06-18 23:43:23 -07:00

43 lines
1.1 KiB
Markdown

# Installation
Webamp can be installed from NPM or included via a script tag using a a free content delivery network (CDN) such as [unpkg](https://unpkg.com/).
:::warning
Keep in mind that if you choose to use a free CDN, that CDN may stop operating at any time. If possible, consider downloading the file and serving it from your own server.
:::
## Install via NPM
```bash
npm install --save webamp
```
From here you can import Webamp in your JavaScript code:
```js
import Webamp from "webamp";
// ... use Webamp here
```
## Import directly from a CDN
ES modules can be imported via URL directly inside a `<script type="module">` tag.
```html
<script type="module">
import Webamp from "https://unpkg.com/webamp@^2";
// ... use Webamp here
</script>
```
## Include via a script tag
This will make the Webamp constructor available as a `window` property: `window.Webamp` keep in mind that you will need to use the `type="module"` attribute on the script tag,
```html
<script src="https://unpkg.com/webamp@^2" type="module"></script>
<script>
const Webamp = window.Webamp;
// ... use Webamp here
</script>
```