Create your own package

What you need

• Node.js 22.12 or newer and npm.
• Your artwork or models, with permission to use them.
• For panorama conversion: Python 3 and Pillow.
• Flower Studio to test your completed package.

Rooms must be 4K

Use a true 360° equirectangular panorama: 4096 × 2048 pixels, with a 2:1 aspect ratio and matching left and right edges. Both the full panorama and the optimized Android panorama must stay at this resolution. A stretched ordinary photo is not a panorama.

Keep the foreground table and plant out of the image; Flower Studio adds them. Save these four images directly in the package’s assets/ folder:

The conversion script preserves 4K resolution and uses quality 95 for the full image. It requires a suitable source; it does not create missing detail or repair projection.

Build your first room

Extract the kit, open a terminal in its folder, and run:

npm install
npm run new -- room my-room
python scripts/prepare-room.py /path/to/panorama.png my-room
npm run build -- my-room
npm run validate -- output/my-room-1.0.0.flower-room.flowerpkg

The starter includes a small lantern model with a notification indicator. Replace it with your design, or remove it for a panorama-only room. Use plant, pot, drink or table instead of room for other starters.

Give your LLM the instructions

Open skills/flower-package-builder/SKILL.md from the kit, or attach the extracted kit to your LLM. Start with this request:

Read the Flower Studio creator skill and package contract. Create my package using the included starter and scripts. Keep model code and assets inside the package, validate the result, and return the .flowerpkg file and checksum. For a room, use 4096 × 2048 panoramas. Tell me which app and Android checks you performed.

The kit documents model interfaces, manifest fields, supported Three.js imports, notifications, model previews, version updates and offline behavior.

How it is packaged

The build script compiles local model code into one module, embeds imported model assets, copies declared artwork and credits, and adds file sizes and SHA-256 checksums. It produces my-room-1.0.0.flower-room.flowerpkg and a checksum file. The archive uses ZIP compression internally; install it with the .flowerpkg extension.

Packages target engine format 1 and Three.js 0.180.0. Keep archives and their total extracted content below 256 MiB. The tooling checks compatibility, checksums and room image dimensions before writing the package.

Install and test

1. Open Flower Studio → Package manager → Install bundle, or drop the finished .flowerpkg into the app.
2. Close the menu to apply the installation, then select your new item.
3. Check the view, lighting, zoom and table placement. For notification indicators, use Position → Notification test.
4. Check offline reload. If using Android, also test the live wallpaper on a device.

To update a package, keep its ID and increase its version. Installation stays local to that browser or device. Model packages run code: use creators you trust.