This repository contains the source code for the Amaranth Playground, a web application that introduces developers to the Amaranth HDL with zero installation required.
This application is built on:
The amount of dependencies is intentionally kept minimal. All code processing tasks (TypeScript compilation, minification, bundling, polyfilling/transpilation, serving in development) are performed by esbuild, which is amazingly flexible and useful.
Requires Node.js and npm. Install them and run:
npm install
npm run serveThis will start a local server at http://localhost:8010/ (or a subsequent port if this one is in use). Any modifications to the source will cause the application to be reloaded with the modifications applied.
If you are using Visual Studio Code, you can also use Shift+Ctrl+B instead.
Except in the amaranth-lang/playground repository, the latest commit in the main branch is built and the result is published to the gh-pages branch. (This lets you show the changes made in your fork to others without them building the application on their machine.)
Only in the amaranth-lang/playground repository, the latest commit in the main branch is built and the result is published to the pages branch, which in turn is published at https://amaranth-lang.org/play/ via a webhook.
This application is released under the two-clause BSD license.
