API Integration for Donation Page: API (`POST /api/products`)

[yusuphjoluwasen]

MVP Design

Why
As a seller
I want to create a new product via the backend API
So that my product is stored in the system and becomes available for buyers to view.

Acceptance Criteria

• Given I fill out the product creation form

• When I tap the "Submit" button

• Then the app should send a POST request to https://cherry-backend-401854471349.europe-west2.run.app/api/products

• And I should see a success message when the product is created successfully.

• Given the API returns a validation error (e.g., missing fields)

• When I submit the form

• Then I should see the error messages mapped to their respective fields.

• Given the API is unreachable or returns a 5xx error

• When I attempt to create a product

• Then the app should show an error message (e.g., "Unable to create product, please try again later") and allow retrying.

API-docs: https://cherry-backend-401854471349.europe-west2.run.app/api-docs/

[matgallacher]

I can pick this up but we need endpoints for the image upload too.

[yusuphjoluwasen]

[yusuphjoluwasen]

I can pick this up but we need endpoints for the image upload too.

I’m suggesting that the app uploads product images directly to Firebase Storage (the implementation is already available in the app: FirebaseService class), then sends the image URLs returned by Firebase, along with other metadata, to the backend endpoint.

I believe approach can save server resources and allow uploads to happen much faster.

For example:
https://firebasestorage.googleapis.com/v0/b/cherry-mvp.firebasestorage.app/o/products/username/productname.png

All product images would be stored under:
https://firebasestorage.googleapis.com/v0/b/cherry-mvp.firebasestorage.app/o/products in Firebase Storage.

[yusuphjoluwasen]

Note: The UI also needs a bit of adjustment, it got messed up a bit during our last cleanup, https://github.com/Cherry-CIC/MVP/tree/main/lib/features/donation

[matgallacher]

That works for m. I'd suggest an image resize extension on the firebase side to optimise images for lists etc.

…

On Fri, 25 Jul 2025, 12:42 GuruKing, ***@***.***> wrote: *yusuphjoluwasen* left a comment (Cherry-CIC/MVP#255) <#255 (comment)> I can pick this up but we need endpoints for the image upload too. I’m suggesting that the app uploads product images directly to Firebase Storage (the implementation is already available in the app: FirebaseService class), then sends the image URLs returned by Firebase, along with other metadata, to the backend endpoint. I believe approach can save server resources and allow uploads to happen much faster. For example: https://firebasestorage.googleapis.com/v0/b/cherry-mvp.firebasestorage.app/o/products/username/productname.png All product images would be stored under: https://firebasestorage.googleapis.com/v0/b/cherry-mvp.firebasestorage.app/o/products in Firebase Storage. — Reply to this email directly, view it on GitHub <#255 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ADCJWBTY53CKTOED5IPWCHT3KIJZPAVCNFSM6AAAAACCA5SEAWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTCMJXGQ3TSMJUGM> . You are receiving this because you commented.Message ID: ***@***.***>

[yusuphjoluwasen]

Good idea!

[CherryCIC]

@yusuphjoluwasen Like you were just saying! A great idea.

[yusuphjoluwasen]

How’s the work on the product integration coming along, @matgallacher?