antonio-gomez / generator-gizmo

Yeoman generator for Adobe extensions

generator-gizmo

Yeoman generator for Adobe Photoshop Extensions

About

Adobe's extension technology is incredibly powerful, allowing developers to push their tools beyond what Adobe natively provides. However, the toolsets surrounding this technology is currently limited. Extension Builder 3 and Builder for Brackets are both good starting points for developers, but they both suffer the same issue - being tied to a particular IDE and providing little help building your project and automating common tasks. Gizmo is an attempt to recitify this and bring modern web development standards to extension building.

Usage

More information in the usage documentation page

Installation

Gizmo requires yeoman, gulp and bower:

npm install -g yo gulp bower

Install generator-gizmo:

npm install -g generator-gizmo

Run

• Be sure you are in your extension directory.
• Windows: C:\Program Files (x86)\Common Files\Adobe\CEP\extensions
• Mac: /Library/Application Support/Adobe/CEP/extensions

Create a new directory, and go to it:

mkdir my_extension && cd $_

Run yo gizmo, and follow the prompts:

yo gizmo

Features

• Webpack - Your front-end source files will be bundled for deployment.
• Multiple JSX - Gizmo preconfigures your extension to load all extendscript files in your /jsx/ directory. No additional code needed.
• Polyfills - Gizmo provides polyfills for JSON and Array in Extendscript.
• SASS - No additional configuration needed to get SASS in your extension.
• Bower and NPM - Manage your dependencies properly with Bower and NPM.
• JSHint - Debug your extension with the power of JSHint.
• Compilation - Gizmo takes the hassle out of compiling your ZXP file and reduces it to a single command.

Roadmap

• Confirm cross-platform compatibility
• Additional polyfills for Extendscript
• Add support for additional Adobe tools (AI, AE, etc)
• JSDoc integration
• Optional scaffolding for popular frameworks (Angular, Backbone, etc)
• Proper test coverage and Travis-CI integration

Other Resources and Special Thanks

Thanks to the following people and groups for their contributions to the extension ecosystem. Gizmo is built on top of what they have shared and created.

• Davide Barranca - Blog
• Andy Hall - Blog
• David Deraedt - Github
• Hallgrimur Bjornsson - Blog
• CEP Cookbook 2015 - Link

License

MIT