Store Location Access

How it works: The Despia Store Location SDK enables your application to access the user's current store location to provide location-based services, regional content, and localized experiences. This lightweight solution runs entirely client-side through despia.storeLocation, requiring no server-side setup or configuration.

Installation

Install the Despia package from NPM:

Copynpm install despia-native

Usage

1. Import the SDK

Copyimport despia from 'despia-native';

2. Get Store Location

Access the store location from the despia.storeLocation variable:

Copy// Simple example - show store location and checkout button
const storeLocation = despia.storeLocation;

// Display in UI
<div>
  <p>Your Store Location: {storeLocation}</p>
  
  {storeLocation === 'USA' && (
    <button onClick={handleWebPayment}>
      Checkout with Web Payment
    </button>
  )}
</div>

// Handle web payment for US users
const handleWebPayment = () => {
  // Process web payment
  console.log('Processing US web payment');
};

Backend Integration

This is merely an illustration; your implementation may differ.

Copy// /api/store-location endpoint
export default async function handler(req, res) {
  const { userId, storeLocation, timestamp } = req.body;
  
  try {
    // Store the location data in your database
    await db.collection('user_locations').doc(userId).set({
      userId,
      storeLocation,
      lastChecked: timestamp,
      createdAt: timestamp
    }, { merge: true });

    res.status(200).json({ success: true });
  } catch (error) {
    res.status(500).json({ error: 'Failed to sync store location' });
  }
}

Resources

• NPM Package

• View full NPM documentation for additional configuration options

Lovable Integration

This SDK is optimized for Lovable's prompt-based AI builder, enabling quick integration of native file sharing capabilities into your generated apps.