supabase / supabase-flutter / 29829394030
86%

DEFAULT BRANCH: main
Ran
Jobs 9
Files 103
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 86.865%. Remained the same
29829394030

push

github

web-flow 
docs(examples): add Storage uploads and image transformations example (#1624)

## What

Adds a new `supabase_flutter` example under
`examples/storage_transforms` that demonstrates Supabase Storage:
uploading images, listing them, serving them through image
transformations, downloading transformed bytes and deleting objects.

Closes SDK-1067.

## The example

A small image gallery:

- **Upload** generated PNG bytes to a public bucket (`uploadBinary`).
- **List** the objects, newest first (`list`).
- **Transform** images on the fly with `TransformOptions` (width,
height, resize mode, quality) via `getPublicUrl`, so the grid loads a
small cropped thumbnail and the detail view renders several resized
variants.
- **Download** transformed bytes (`download`).
- **Delete** an object (`remove`).

All Storage access lives in `lib/storage_repository.dart`, kept separate
from the UI so it is easy to read and to drive from an integration test.
Sample images are drawn in memory in `lib/sample_image.dart`, so the
example uploads real image bytes without bundling asset files or
depending on an image picker.

## Backend wiring

- New migration
`examples/supabase/migrations/20240603000000_storage_transforms_example.sql`
creates a public `images` bucket with row level security policies
allowing the demo to view, upload, overwrite and delete objects with the
publishable key.
- `examples/supabase/config.toml` enables
`[storage.image_transformation]`.
- Registered `examples/storage_transforms` in the root workspace and the
`examples/README.md` table.

## Testing

Verified end to end against the local stack (`supabase db reset`, then
upload/list/transform-render/authenticated-transformed-download/delete
over HTTP): uploads succeed, the public render endpoint returns a
resized image, and deletes clean up. `dart format` and `flutter analyze`
are clean.

The end-to-end integration test is a follow-up stacked PR, matching the
other examples.

5575 of 6418 relevant lines covered (86.87%)

3.92 hits per line

Jobs
ID Job ID Ran Files Coverage
8 functions_client - 29829394030.8 3
98.85
 GitHub Action Run
9 yet_another_json_isolate - 29829394030.9 1
93.65
 GitHub Action Run
7 storage_client - 29727256785.7 13
84.63
 GitHub Action Run
5 postgrest - 29727256785.5 10
85.33
 GitHub Action Run
7 supabase - 29826021481.7 17
83.2
 GitHub Action Run
8 realtime_client - 29826021481.8 11
90.14
 GitHub Action Run
9 supabase_flutter - 29826021481.9 10
79.31
 GitHub Action Run
8 supabase_common - 29727256785.8 10
100.0
 GitHub Action Run
3 gotrue - 29727256785.3 28
87.6
 GitHub Action Run
Source Files on build 29829394030