Repository navigation
Releases
Releases · pavelpascari/pixel-studio
Pixel Studio v0.2.0-alpha.2
Renamed: pixel-studio is now @pixel-studio/core
- The engine package moves into the
@pixel-studioorganisation, next to@pixel-studio/runtime:
npm i @pixel-studio/core. Imports change with it:@pixel-studio/core,@pixel-studio/core/internal,
@pixel-studio/core/runtime,@pixel-studio/core/stage,@pixel-studio/core/node/png; the example paths become
node_modules/@pixel-studio/core/examples/. Thepixelcommand is unchanged. pixel-studioon npm stays at 0.2.0-alpha.1 and is deprecated, pointing here.
Pixel Studio v0.2.0-alpha.1
On npm, as two packages
pixel-studio(the engine, thepixelCLI, figures, examples, motion references and the reference docs) and
@pixel-studio/runtime(<pixel-sprite>,<pixel-stage>and<pixel-actor>) are published on npm, always
with the same version:npm i pixel-studio, ornpm i @pixel-studio/runtimefor a site that only plays sprites.
The runtime has no dependencies and never imports the engine;pixel-studiodepends on exactly its version.pixel-studio/runtimeandpixel-studio/stagekeep working: they re-export the runtime package. In the runtime
package the files aresrc/pixel-sprite.jsandsrc/pixel-stage.js(weresrc/runtime/inpixel-studio), and
the imports are@pixel-studio/runtimeand@pixel-studio/runtime/stage.- The
pixel-studiopackage no longer ships the research notes (docs/research/); they stay in the repository.
Guide
- The hand-written guide pages (
site/) move into pixel-studio.sh as the Guide (/docs/guide/): the same nine
topics, every live example running next to its code (now with the site's highlighting, copy button and themes) and
every editable character redrawn by the engine as you type.site/is gone;scripts/browser-check.mjschecks
the guide's pages instead.
Repository
- Laid out as npm workspaces:
packages/pixel-studio/,packages/runtime/, with the studio, demos, guide pages
and website around them.npm installlinks the two packages; there are still no third-party dependencies. - Generated files are no longer committed:
demo/assets/(built bynpm run build:demo, and by the website's build)
andpreviews/(which still held a contact sheet of a character that no longer exists). - CI on every push and pull request: both packages' tests on Node 20 and 24, Markdown links, the packed packages
installed and used from a fresh folder, and the website build. Releases are staged on npm from a signed tag and
approved by a maintainer with 2FA (see CONTRIBUTING.md).
Removed
demo/pp.html, the P/P studio site sketch: it is a personal site, not an engine demo, so it no longer ships here.
Pixel Studio 0.2.0-alpha.0
The first alpha of Pixel Studio: describe a character as JSON (shapes on a skeleton, materials, animations), and the engine draws it as pixel art at every size; websites play it with one tag. Zero dependencies, MIT.
npm i github:pavelpascari/pixel-studio#v0.2.0-alpha.0Start with Getting started: a goose of your own on a web page in five steps.
What's in it
- Engine and CLI: specs validated with JSON paths and did-you-mean; renders at 16/32/64 px with three detail tiers;
pixel validate | preview | ascii | bundle | export | where | resolve | figures | brief; Aseprite-format export for Phaser and PixiJS. - Figures with real motion: goose (with front and back views), human, dog, chibi, blob; gaits with planted feet, jumps, climbs, sits, flight, follow-through. Several motions are measured from Muybridge's plates and published studies, every value cited in
references/. <pixel-sprite>: one file, no imports. Picks the sharpest sheet, scales in whole device pixels, events, attachment points, hit testing, state machines, skins, reduced motion.<pixel-stage>: characters that walk, jump, climb, sit and hide on your page's own elements, with JSON scenes.- Examples: six geese, Ember the fox, Pip, Bolt, Gloop, and Moss, a new beetle.
Breaking changes since 0.1
- Events are now
pixel-*, bubbling and composed (pixel-ready,pixel-end,pixel-event,pixel-tap,pixel-activity, …). The old names still fire in this alpha and will be removed after it. <pixel-sprite>load status isstatus(stateis an alias for this alpha);<pixel-actor>behaviour isactor.activity.- The core entry exports the pipeline only; building blocks moved to
pixel-studio/internal; registries are read throughshapeTypes(),textures(),motionModels(),leggedModels(). - Stricter validation (numbers, sizes, coordinates within 4 canvas sizes, renders up to 512 px, reserved names).
- Clawd is replaced by Moss, an original character.
Full list: CHANGELOG.md.
Alpha means
The spec and bundle formats may still change before 1.0, and each change will be in the changelog. Not on npm yet.