Skip to content

Latest commit

 

History

History
51 lines (41 loc) · 2.41 KB

README.md

File metadata and controls

51 lines (41 loc) · 2.41 KB

giphy api

A WebAssembly application that allows a user to search for and save animated GIFs to a user profile using the GIPHY API.

overview

The API is structured as a very simple JSON RPC API built using 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.

We are using Postgres for data storage & launchbadge/sqlx for the interface.

setup

First, you'll need Rust. Head on over to 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:

# 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 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.

# 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 to get started.


demo images mobile