Overview

jsii allows code in any language to naturally interact with JavaScript classes. It is the technology that enables the AWS Cloud Development Kit to deliver polyglot libraries from a single codebase!

A class library written in TypeScript can be used in projects authored in TypeScript or Javascript (as usual), but also in Python, Java, C# (and other languages from the .NET family), ...

❓ Documentation

Head over to our documentation website!

The jsii toolchain is spread out on multiple repositories:

aws/jsii-compiler is where the jsii compiler is maintained (except releases in the 1.x line)
aws/jsii-rosetta is where the jsii-rosetta sample code transliteration tool is maintained (except releases in the 1.x line)
aws/jsii is where the rest of the toolchain is maintained, including:
- @jsii/spec, the package that defines the .jsii assembly specification
- jsii-config, an interactive tool to help configure your jsii package
- jsii-pacmak, the bindings generator for jsii packages
- jsii-reflect, a higher-level way to process .jsii assemblies
- The jsii runtime libraries for the supported jsii target languages
- 1.x release lines of jsii and jsii-rosetta

📖 Blog Posts

Here's a collection of blog posts (in chronological order) related to jsii:

2020-01-11: How to Create CDK Constructs, by Matthew Bonig
2020-05-27: Generate Python, Java, and .NET software libraries from a TypeScript source, by Hari Pachuveetil
2020-12-23: How the jsii open source framework meets developers where they are , by Romain Marcadier

ℹ️ If you wrote blog posts about jsii and would like to have them referenced here, do not hesitate to file a pull request to add the links here!

⚙️ Contributing

See CONTRIBUTING.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{AWS CDK Automation} 🚧 👀	_{Aaron Costley} 🐛 💻 🤔 👀	_{Abdallah Hodieb} 🐛	_{Adam Ruka} 🐛 💻 🚧 👀	_{Adrian Dimech} 💻	_{Alex Pulver} 🐛	_{Andi Pabst} 🐛
_{Andrew Wason} 🐛 💻	_{Andy Slezak} 💻	_{Ansgar Mertens} 🚧 💻 🐛	_{Anshul Guleria} 🤔	_{Ari Palo} 🤔	_{Armaan Tobaccowalla} 🐛	_{Bartłomiej Jurek} 🐛
_{Ben Bridts} 📖	_{Ben Chaimberg} 📖	_{Ben Farr} 📖	_{Ben Walters} 🤔	_{Benjamin Macher} 📖	_{Benjamin Maizels} 💻 👀	_{Bill Cauchois} 🤔
_{Brecht Verhoeve} 🤔	_{Breland Miley} 💻	_CaerusKaru 💻 🚧	_{Calvin Combs} 💻 👀	_{Camilo Bermúdez} 🐛	_{Campion Fellin} 💻	_{Carter Van Deuren} 🐛
_{Chris Garvis} 📖	_{Christian Moore} 🐛	_{Christophe Vico} 🐛	_{Christopher Currie} 💻 🤔	_{Christopher Rybicki} 📖 🐛 💻	_{CommanderRoot} 💻	_{Cory Hall} 🐛
_{Cristian Măgherușan-Stanciu} 🐛	_{CyrusNajmabadi} 🐛 🤔	_{Damian Silbergleith} 💻 🐛	_{Daniel Dinu} 🐛 💻	_{Daniel Schmidt} 🐛 💻	_{Daniel Schroeder} 🐛 💻 📖 🤔 🚧	_{Dave Slotnick} 🐛
_{Donald Stufft} 🐛 💻 🤔 👀	_{Dongie Agnir} 💻 👀	_{Eduardo Rabelo} 📖	_{Eduardo Sena S. Rosa} 🐛	_{Elad Ben-Israel} 🐛 💻 🤔 🚧 👀 📢	_{Eli Polonsky} 🐛 💻 🤔 🚧 👀	_{Eric Z. Beard} 📆
_{Erik Karlsson} 🐛	_{Eugene Kozlov} 💻	_{Fabio Gentile} 🐛	_{Florian Eitel} 🤔	_{Glib Shpychka} 🐛	_{Graham Lea} 🤔 👀	_{Hamza Assyad} 🐛 💻 🤔 👀
_{Hari Pachuveetil} 📝 📖	_{Hogan Bobertz} 💻	_{Hsing-Hui Hsu} 💻 📖 🤔 👀	_{Ikko Ashimine} 📖	_James 🐛 💻	_{James Kelley} 🐛	_{James Mead} 💻
_{James Siri} 💻 🚧	_{Jason Del Ponte} 🤔 👀	_{Jason Fulghum} 🤔 📆 👀	_{Jeff Malins} 💻	_{Jerry Kindall} 📖 🤔	_{Jimmy Gaussen} 🤔	_{Johannes Weber} 📖
_{John Pantzlaff} 💻	_{Jon Steinich} 🐛 🤔 💻	_{Joseph Lawson} 👀	_{Joseph Martin} 🐛	_Junix 🐛	_{Justin Frahm} 🐛	_{Justin Taylor} 🐛
_{Kaizen Conroy} 💻 🐛	_{Kaizen Conroy} 💻	_{Kaushik Borra} 🐛	_{Knut O. Hellan} 🐛	_{Kyle Thomson} 💻 👀	_{Leandro Padua} 🐛	_{Liang Zhou} 🐛 💻
_{Madeline Kusters} 💻 🐛	_{Maja S Bratseth} 🐛	_{Marcos Diez} 🐛	_{Mark Nielsen} 💻	_{Matthew Bonig} 🐛 📝	_{Matthew Pirocchi} 💻 🤔 👀	_{Meng Xin Zhu} 🐛
_{Michael Neil} 🚧	_{Mike Lane} 🐛	_{Mitch Garnaat} 🐛 💻 🤔 👀	_{Mitchell Valine} 🐛 💻 🤔 🚧 👀	_{Mohamad Soufan} 📖	_{Mykola Mogylenko} 🐛	_Naumel 👀
_{Neta Nir} 💻 🤔 🚧 👀	_{Nick Lynch} 🐛 💻 🚧 👀	_{Niranjan Jayakar} 🐛 💻 🤔 🚧 👀	_{Noah Litov} 💻 🚧 👀	_{Otavio Macedo} 💻 🐛	_{PIDZ - Bart} 🤔	_{Peter Woodworth} 🚧
_{Petr Kacer} 🐛	_{Petra Barus} 💻	_{Philip Cali} 🤔	_{Quentin Loos} 🤔	_Raphael 🐛	_{Richard H Boyd} 🐛	_{Rico Huijbers} 🐛 💻 🤔 🚧 👀
_{Romain Marcadier} 🐛 💻 🎨 🤔 🚧 👀 📝	_{SADIK KUZU} 👀	_SK 🤔	_{Sam Fink} 💻 👀	_{Sam Goodwin} 👀	_{Sebastian Korfmann} 🐛 💻 🤔	_{Sepehr Laal} 🐛
_{Shane Witbeck} 🤔	_{Shiv Lakshminarayan} 💻 🚧 👀	_Somaya 💻 🤔 🚧 👀	_{Stephen Kuenzli} 📖	_{Takahiro Sugiura} 📖	_{The Gitter Badger} 💻 🚧	_{Thomas Poignant} 🐛
_{Thomas Steinbach} 🐛	_{Thorsten Hoeger} 💻	_{Tim Wagner} 🐛 🤔	_{Tobias Lidskog} 💻	_{Tom Bonner} 🐛	_{Ty Coghlan} 🐛	_{Tyler van Hensbergen} 🤔
_{Vlad Hrybok} 🐛	_{Vladimir Shchur} 🐛	_{Yan Zhulanow} 💻	_{Yigong Liu} 🐛 🤔	_{Zach Bienenfeld} 🐛	_ajnarang 🤔	_aniljava 💻
_{arnogeurts-sqills} 🐛 💻	_cn-cit 🐛	_deccy-mcc 🐛	_{dependabot-preview[bot]} 🐛 🚧	_{dependabot[bot]} 🚧	_dheffx 🐛	_gregswdl 🐛
_guyroberts21 📖	_{mattBrzezinski} 📖	_mergify 🚧	_mergify[bot] 🚧	_nathannaveen 🚧	_seiyashima42 🐛 💻 📖	_sullis 💻
_vaneek 🐛	_wendysophie 🐛