https://github.com/akkoro/assemblylift-template-jamstack
https://github.com/akkoro/assemblylift-template-jamstack
cloud cloudnative jamstack javascript rust rust-lang serverless webassembly
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/akkoro/assemblylift-template-jamstack
- Owner: akkoro
- Created: 2021-08-10T13:49:58.000Z (almost 5 years ago)
- Default Branch: mainline
- Last Pushed: 2021-08-10T20:45:12.000Z (almost 5 years ago)
- Last Synced: 2025-06-13T14:06:17.996Z (about 1 year ago)
- Topics: cloud, cloudnative, jamstack, javascript, rust, rust-lang, serverless, webassembly
- Language: JavaScript
- Homepage: https://assemblylift.akkoro.io
- Size: 78.1 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
AssemblyLift Jamstack Template
------------------------------
The repository provides a template for bootstrapping an AssemblyLift [Jamstack](https://jamstack.org) application.
[AssemblyLift](https://assemblylift.akkoro.io) **v0.3.1** or greater is required.
Install assemblylift with `cargo install assemblylift-cli`.
The `web` directory is a simple site built by webpack to demonstrate how a frontend can be integrated with an AssemblyLift project.
This could be replaced by a static site generator or a full-featured SPA framework such as React if desired.
### Building
You will need `npm` and `cargo` installed & available on your system. Your cargo/rust toolchain must also have the
`wasm32-unknown-unknown` build target installed.
- First run `npm install` to install webpack et al.
- The web frontend is built by running `npm run build`. The output of webpack is `./dist`, the contents of which will
be embedded in your deployed function.
- The AssemblyLift services can be built as usual with `asml cast` and deployed with `asml bind`.
- ⚠️ You will need an AWS account & credentials
See the [AssemblyLift documentation](https://docs.assemblylift.akkoro.io) for more details.
### How it works
The function `www/server` uses the `rust-embed` crate to embed the contents of the webpack `dist` directory in the compiled
WebAssembly binary. When invoked, the function proxies the path and attempts to match & return one of the embedded assets,
returning a 404 if an exact match is not found.