update readme

Author: mssalemi

README.md

@@ -2,28 +2,28 @@
 
 A high-performance API for building Shopify Functions using WebAssembly (WASM).
 
-
 ## Architecture
 
 The WASM API consists of these main components:
 
-1. **Core (`core/`)**
-   - Low-level WASM bindings and memory management
-   - Handles raw memory operations and string handling
-   - Provides the foundation for the API layer
-   - Manages direct WASM imports/exports
+1. **Provider (`provider/`)**
+    - Implements low-level WASM operations for:
+        - Memory management and allocation
+        - Input/output serialization
+        - Context lifecycle management
+    - Used by the API layer for high-level operations
+    - Integrates with trampoline for WASM module linking
+
+2. **Core (`core/`)**
+    - Defines fundamental types and interfaces
+    - Used by both API and provider layers
 
-2. **API (`api/`)**
-   - High-level interface for writing Shopify Functions
-   - Provides the `#[shopify_function]` macro
-   - Handles input/output operations with a user-friendly API
-   - Built on top of the core package
+3. **API (`api/`)**
+    - High-level Rust interface for writing Shopify Functions
+    - Includes examples and documentation
 
-3. **Trampoline (`trampoline/`)**
-   - Bridges communication between your WASM module and Shopify's runtime
-   - Handles memory sharing between guest and provider modules
-   - Manages string operations and object property access
-   - Creates the necessary WASM imports/exports
+4. **Trampoline (`trampoline/`)**
+    - Bridges communication between WASM modules
 
 ## Getting Started
 
@@ -32,13 +32,6 @@ The WASM API consists of these main components:
 - [Rust](https://www.rust-lang.org/tools/install) (latest stable version)
 - [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/) for building WebAssembly modules
 
-### Installation
-
-Add the Shopify Function WASM API to your `XYZ`:
-
-```
-  // todo
-```
 
 ### Basic Usage
 
@@ -59,15 +52,21 @@ fn function(context: &mut Context) -> Result<()> {
 }
 ```
 
-The trampoline tool bridges communication between your WASM module and Shopify's runtime. You can trampoline your function by:
+To build a function example, create a new example and build it targeting `wasm32-wasi` with `shopify_function_wasm_api` as the provider:
+
+```shell
+cargo build --release --target wasm32-wasip1 -p shopify_function_wasm_api --example echo
+```
+
+
+The trampoline tool bridges communication between your WASM module and Shopify's runtime. To trampoline your function wasm:
 
 ```shell
 # Short flags
 cargo run -p shopify_function_wasm_api_trampoline -- -i input.wasm -o output.wasm
 ```
 
-
-For more examples, check out the [examples directory](./api/examples/).
+For examples, check out the [examples directory](./api/examples/).
 
 ## Documentation