Shopping Cart & Checkout

LarpLand provides a streamlined shopping cart and checkout experience for purchasing roleplay items and equipment.

​

Viewing Your Cart

Access your shopping cart at any time:

• Tap the shopping cart icon in the top-right corner of the catalog screen
• The icon shows a badge with your total item count
• The icon changes from outlined to filled when you have items in your cart

​

Empty Cart State

If your cart is empty, you’ll see:

• A message: “Tu carrito esta vacio”
• Helpful text prompting you to browse the catalog
• A “Volver al catalogo” button to return to shopping

​

Managing Cart Contents

Each item in your cart is displayed with:

• Product thumbnail: 76x76px image
• Product name: Truncated to 1 line if too long
• Unit price: Price per individual item
• Line total: Unit price × quantity
• Quantity controls: Adjust the number of items

​

Adjusting Quantities

​

Removing Items

To remove items from your cart:

• Remove one: Tap the minus button until quantity reaches zero
• Clear entire cart: Tap “Vaciar” in the top-right corner to empty your cart completely

​

Cart Summary

At the bottom of the cart screen, you’ll see:

• Total amount: Sum of all line totals in euros (€)
• Checkout button: “Continuar al checkout” to proceed with your purchase

The total updates automatically as you adjust quantities.

​

Checkout Process

When you’re ready to complete your purchase:

​

Store Pickup Option

If you select store pickup:

• No shipping address is required
• An information banner explains: “Recibiras una confirmacion cuando tu pedido este listo”
• Pickup location is automatically set to “Tienda LarpLand”

​

Order Confirmation

After successful checkout:

1. Product stock levels are automatically updated
2. Your order is saved with a unique order ID
3. A confirmation dialog appears with your order number
4. Your cart is cleared automatically
5. You return to the catalog

​

Shipping Costs

Shipping is calculated based on your delivery method and subtotal:

​

Error Handling

​

Insufficient Stock

If a product’s stock becomes insufficient during checkout:

• The system checks stock availability before processing
• An error message identifies the specific product
• Stock changes are rolled back
• You can adjust your cart and try again

​

Validation Errors

The checkout form validates:

• Required fields are filled
• Phone number has at least 7 digits
• Postal code has at least 4 digits
• Shipping address fields are complete (when applicable)

Missing or invalid fields are highlighted with error messages.

​

Processing State

While your order is being processed:

• The “Confirmar compra” button shows a loading spinner
• The button is disabled to prevent duplicate submissions
• Button text changes to “Procesando…”

This typically takes just a few seconds.

​

Viewing Order History

Access your past orders to track purchases and review order details.

​

Accessing Order History

From the Profile tab:

​

Order List View

Your orders are displayed in a scrollable list, showing:

• Order number: Unique ID for each order (e.g., “Pedido #123”)
• Order date: Date and time in DD/MM/YYYY HH:MM format
• Item count: Total number of items in the order
• Total amount: Final price in euros
• Order status: Visual badge showing current status

​

Order Status Badges

Orders display color-coded status indicators:

• Pendiente (Pending): Yellow badge - Order awaiting processing or payment
• Completado (Completed): Green badge - Order successfully fulfilled
• Other statuses display with a neutral badge

​

Viewing Order Details

Tap any order card to expand and view:

• Product thumbnails: 52x52px images of each item
• Product names: Full item descriptions
• Quantities: Number of each item ordered
• Unit prices: Price per item
• Line totals: Quantity × unit price for each item

​

Empty State

If you haven’t placed any orders yet, you’ll see:

• An icon: receipt_long_outlined
• Message: “Todavia no tienes pedidos”

​

Refreshing Orders

Pull down on the order history screen to refresh and load the latest order data from Firebase.

​

Cart Persistence

Your cart is maintained in memory using a state provider:

• Items persist as you navigate between screens
• Returning from product detail pages preserves your cart
• Your cart is cleared after successful checkout
• Cart data is lost if you close the app (not persisted to storage)