node package manager
Orgs are free. Discover, share, and reuse code in your team. Create a free org ยป

anione

Anione

A CLI (NPM) tool to ease the repetitiveness that comes with coding HTML5 banner ads. Animate one banner with Greensock's animation library, resize it, preview it, package it, done. Anione lets you focus on the animation.

Once you've animated your first banner, you can run resize and then easily tweak that animation for each size, giving you full control over each size.

After that, it's often necessary to send the banners for review to a client or within an agency, that's what the preview command is for. Just drag and drop the preview folder on a publicly accessible server and it's ready for sharing.

Once you're ready to package the banners, just run the handoff command. This command grabs all related images and global css/js assets for each banner. Then makes a version of the banner for each vendor, and zips it up. Then all banners are zipped into one nice packaged file.

Development Experience

Anione is all about making the development experience of HTML5 banner animation easier and more pleasant. As such, there is a centralized view where you can ajax load each banner with a timeline scrubber. This view is loaded with Browser Sync after both of the ani one, ani resize, and ani watch commands.

Commands:

  • init โ€“ Builds Anione project directory structure and config.
  • one โ€“ Generates first banner from template.
  • resize โ€“ Resize your first banner into all remaining sizes selected during configuration. These can also be found in your ani-conf.json file.
  • watch - Run a BrowserSync server to watch the banners and launch the generated index.html
  • preview - Generate a drag n' drop preview webpage to showcase the banners.
  • stage - Via rsync, copy preview to a stage server to showcase the banners.
  • handoff - Zip/Package/Compress the Banner-Ads for ad-network delivery.

Options:

  • -h, --help output usage information
  • -V, --version output the version number

Asset naming conventions

Layers for HTML5 Banners

These are images that you'll use within the HTML5 banners. Be sure that each banner has it's own images. Even if banners use the same image, each banner will need their own. Place all of these images in assets/images/ during development. These will be copied into each individual banner directory when you run the handoff command. To work with anione, name them as follows: size-layername.extension (Example: cta-300x600.png). Checkout this Photoshop script to export image layers quickly.

Static backups

These are often used by vendors as statics when HTML5 banners aren't able to load in a visitors browser. To work an anione, you'll want to put them within the assets/statics/ dir, and name them as follows: size-static.extension (Example: 300x600-static.png). Checkout this Photoshop script to export static backups quickly.

CSS & JS Libraries

You're more than welcome to use custom CSS & JS libraries with your project. In fact anything within the assets/libs-css/ and assets/libs-js/ directories will be copied into each banner during handoff generation.

Generated Project Structure

  • ani-conf.json
  • README.md
  • .gitignore
  • assets
    • statics
      • (size-static.jpg)
      • (size-static.png) ...
    • images
      • (size-layer.jpg)
      • (size-layer.png) ...
    • libs-js
      • (js-library.js) ...
    • libs-css
      • (css-library.css) ...
  • banners
    • (size.html) ...

Checking File Size

If your project has a file size restriction, you may want to check the size of your banner at any given point of it's development. You can easily do this by running ani handoff to generate a handoff.zip. After that, unzip the handoff and then view each banner's file size within your file viewer.