https://github.com/thedodd/giphy-api
A Rust WebAssembly web application & API.
https://github.com/thedodd/giphy-api
no-javascript postgres rust wasm webassembly
Last synced: 2 months ago
JSON representation
A Rust WebAssembly web application & API.
- Host: GitHub
- URL: https://github.com/thedodd/giphy-api
- Owner: thedodd
- Created: 2019-03-22T04:18:25.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-16T02:53:18.000Z (about 5 years ago)
- Last Synced: 2025-04-15T06:16:48.749Z (2 months ago)
- Topics: no-javascript, postgres, rust, wasm, webassembly
- Language: Rust
- Homepage: https://thedodd.github.io/giphy-api/
- Size: 2.17 MB
- Stars: 8
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
giphy api
=========
A WebAssembly application that allows a user to search for and save animated GIFs to a user profile using the [GIPHY API](https://developers.giphy.com/docs/).
### overview
The API is structured as a very simple JSON RPC API built using [actix.rs](https://actix.rs/). The client & server use the same exact data models for communicating over the network. All interaction is protected by JWT authN/authZ.
The client app is a WebAssembly (WASM) application built using Rust & the [Seed framework](https://seed-rs.org).
We are using Postgres for data storage & [launchbadge/sqlx](https://github.com/launchbadge/sqlx) for the interface.
#### setup
First, you'll need Rust. Head on over to [rustup.rs](https://rustup.rs/) and follow the instructions there to setup the Rust toolchain. After that, let's also add the needed compiler target for the WASM instruction set:
```bash
# Add the WASM 32-bit instruction set as a compilation target.
rustup target add wasm32-unknown-unknown
# While we're at it, let's install the wasm-bindgen-cli
# which we will need for our WASM builds.
cargo install wasm-bindgen-cli --version=0.2.55
```
Second, you'll need to have docker in place to run the Postgres database, check out the [docker installation docs](https://docs.docker.com/get-docker/) if you don't already have docker on your machine.
Now that you have all of the tools in place, let's bring up the DB and build our Rust code.
```bash
# Boot Postgres. This will also initialize our tables.
docker run -d --name postgres \
-e POSTGRES_PASSWORD=pgpass -p 54321:5432 \
-v `pwd`/pg.sql:/docker-entrypoint-initdb.d/pg.sql \
postgres
# Build the UI.
cargo build -p client --release --target wasm32-unknown-unknown
# Run wasm-bindgen on our output WASM.
wasm-bindgen target/wasm32-unknown-unknown/release/client.wasm --no-modules --out-dir ./static
# Now, we run our API which will also serve our WASM bundle, HTML and other assets.
cargo run -p server --release
```
Now you're ready to start using the app. Simply navigate to [localhost:9000](http://localhost:9000) to get started.
----
### demo images mobile
