Connect your app to Lightspeed

1. 1

   Go to the 'Connectors' section in Lovable and select 'Lightspeed'.

   This is where you manage all your connections to external services.

2. 2

   Click 'Add connection' and give your connection a display name, like 'Lightspeed Prod'.

   This name helps you identify your Lightspeed connection within Lovable.

3. 3

   Choose your authentication method: 'Managed by Lovable' for the fastest setup, or 'Lightspeed' if you want to use your own OAuth application.

   This determines how Lovable connects to Lightspeed on your behalf. 'Managed by Lovable' is simpler as Lovable handles the technical setup, while 'Lightspeed' gives you more control over the application details.

4. 4

   If you chose 'Managed by Lovable', enter your store's domain prefix (e.g., 'my-store' from `https://my-store.retail.lightspeed.app`).

   This tells Lovable which specific Lightspeed store to connect to.

5. 5

   If you chose 'Lightspeed' (your own OAuth app), first go to the Lightspeed developer dashboard, create or open your OAuth application, add the Lovable redirect URI (which will be shown during the connect flow), save it, then copy your Client ID and Client Secret. Back in Lovable, paste the Client ID and Client Secret, and enter your store's domain prefix.

   This links your custom Lightspeed application to Lovable, allowing you to control its branding and permissions.

6. 6

   Optionally, expand 'Advanced settings' to review or change the permissions (scopes) your app will request from Lightspeed.

   This ensures your app only has access to the data it needs, improving security.

7. 7

   Choose who can use this connection within your Lovable workspace. By default, 'Managed by Lovable' connections are shared with everyone, while 'Lightspeed' connections are private to you.

   This controls access to the Lightspeed data for other people in your team.

8. 8

   Click 'Connect', then sign in to Lightspeed if prompted, review the requested permissions, and click 'Allow'.

   This authorizes Lovable to access your Lightspeed data according to the permissions you selected.

9. 9

   Once connected, ask Lovable in your project chat to link your project to this Lightspeed connection.

   This makes the Lightspeed data available for use within your specific Lovable project.

Connect my Lovable app to Lightspeed Retail X-Series. I want to build an inventory dashboard that shows stock by outlet, low-stock products, and recent stock changes. Please make sure the connection has the necessary permissions to read product and inventory data.

OAuth application

A secure way for one online service (like Lovable) to get permission to access data from another online service (like Lightspeed) on your behalf, without sharing your password. It's like giving a trusted app a special key to specific parts of your data.

Client ID

A public identifier for your specific OAuth application, used by Lightspeed to recognize which app is asking for access.

Client Secret

A secret password for your OAuth application, used by Lightspeed to verify that the request is coming from your legitimate app and not an imposter.

Domain Prefix

The unique part of your Lightspeed store's web address, like 'my-store' in `https://my-store.retail.lightspeed.app`.

Scopes

Specific permissions that define what kind of data your app can read or change in Lightspeed, such as 'read products' or 'read customers'.

• Not having the correct permissions in your Lovable workspace to create connections.
• Forgetting your Lightspeed store's domain prefix.
• Not configuring the redirect URI correctly in your Lightspeed OAuth application if you're using your own app.
• Browser pop-up blockers preventing the Lightspeed authorization window from opening.
• Not linking the Lightspeed connection to your specific project after creating it, which means your app won't be able to use it.
• Expecting Lovable to bypass Lightspeed's own API limits or your Lightspeed account's permissions.
• Assuming that deleting a connection in Lovable will also delete your Lightspeed account or OAuth application (it only removes the link from Lovable).