supabase / supabase-flutter / 29829394030 / 8
86%
main: 86%

DEFAULT BRANCH: main
Ran
Files 3
Run time 0s
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: 98.851%. Remained the same
29829394030.8

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.

86 of 87 relevant lines covered (98.85%)

1.54 hits per line

Source Files on job functions_client - 29829394030.8