@nanonomad/web

One npm install for vanilla JavaScript or any bundler (Vite, webpack, etc.): includes @nanonomad/core and @nanonomad/characters as dependencies.

For React or Next.js, use @nanonomad/react instead (it also installs core + characters for you).

Install

npm install @nanonomad/web

Quick start

import NanoNomad, { createBrowserHost, getCharacterUrls } from '@nanonomad/web'

const urls = getCharacterUrls('default')

const pet = new NanoNomad({
  host: createBrowserHost(window),
  runtimeConfig: {
    ...urls,
    movementSpeed: 50,
    behaviorFrequency: 50,
    mobileEnabled: true,
    persistenceEnabled: false,
    enabledCapabilities: ['idle', 'walk', 'jump', 'sit', 'fall'],
    customColors: {},
  },
})

await pet.start()

Import base and character CSS from the installed package (paths work with bundlers):

import '@nanonomad/characters/assets/pet.css'
import '@nanonomad/characters/assets/default/default.css'

Self-hosted assets: npx nanonomad-characters-copy ./public/nanonomad-characters (CLI ships with @nanonomad/characters).

License

GPL-2.0-or-later