Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xfbs/diff.rs
Web application to render a diff between Rust crate versions. Implemented in Yew, runs fully in the browser as WebAssembly.
https://github.com/xfbs/diff.rs
diff rust site static wasm yew yew-router
Last synced: about 22 hours ago
JSON representation
Web application to render a diff between Rust crate versions. Implemented in Yew, runs fully in the browser as WebAssembly.
- Host: GitHub
- URL: https://github.com/xfbs/diff.rs
- Owner: xfbs
- License: mit
- Created: 2023-03-07T22:33:18.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-12T21:04:28.000Z (7 months ago)
- Last Synced: 2024-04-13T04:47:54.889Z (7 months ago)
- Topics: diff, rust, site, static, wasm, yew, yew-router
- Language: CSS
- Homepage: https://diff.rs
- Size: 409 KB
- Stars: 84
- Watchers: 2
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-yew - diff.rs - Web application to render a diff between Rust crate versions. Implemented in Yew, runs fully in the browser as WebAssembly, [Live Demo](https://diff.rs). (Projects)
README
# diff.rs
[](https://gitlab.com/xfbs/diff.rs/-/pipelines)
Web application to view the difference between Rust crate versions. It is
deployed at [diff.rs](https://diff.rs).
## How it works
It uses [Yew](https://yew.rs) as the reactive frontend framework, and [Tailwind
CSS](https://tailwindcss.com) for the styling.
The code in this repository compiles into a WebAssembly binary that runs in the
browser. Since it only talks to the [crates.io](https://crates.io) API, it does
not need any backend and can be hosted statically.
The [Architecture](docs/architecture.md) document explains the details of how
it works.
## How to launch it
You need a recent version of Rust, which is most easily installed with
[rustup.rs](https://rustup.rs).
In addition, you will also need [Trunk](https://trunkrs.dev/), which is a tool
that helps to build Rust WebAssembly applications, and the WebAssembly build
target for Rust. You can install it like this:
```
cargo install trunk
rustup target add wasm32-unknown-unknown
```
You can then use trunk to launch a local server with hot-reloading for
development purposes:
```
trunk serve
```
You can also use it to build an optimized release version. This will place the
build output into the `dist` folder. The `--release` flag enables some
optimization, both building the Rust code in release mode, and running
`wasm-opt` for further size savings. You might see a large speedup from running
it this way.
```
trunk build --release
```
## How it is deployed
It is currently hosted by GitLab Pages using [this CI config](.gitlab-ci.yml).
It serves the application statically, and uses both gzip and brotli compression
for smaller assets and faster loading times.
The deployed version of it has privacy-preserving (cookie-less) analytics
enabled to help me measure how many people are actively using it. If you have
an adblocker, this is likely blocked by it. You can see the data
[here][analytics]
See [Deployment](docs/deployment.md) for more information on how this works.
## How to contribute
Contributions to `diff.rs` are more than welcome. Feel free to check out the
open [issues][] for inspiration.
See [Contributing](docs/contributing.md) for more information on how to
contribute.
## License
MIT, see [LICENSE.md](LICENSE.md).
[analytics]: https://counter.dev/dashboard.html?user=xfbs&token=4kPlix1Li7w%3D
[issues]: https://github.com/xfbs/diff.rs/issues