Get Started with Extensions

This page provides all the steps needed to create your first extension. It covers the following tasks:

1. Install Fynd Development Kit Command-line Interface (FDK-CLI)
2. Generate boilerplate for extension
3. Populate test data
4. Preview your extension

Prerequisites

Before getting started, you'll need the following:

• Git↗ and Node.js v18↗ or later
• Account in Fynd Partners↗
• Development Company

Steps to create a Development Company

1. Go to Fynd Partners↗.
2. Login to the Fynd Partners.
3. Select a suitable organization.
4. In the left pane, click Companies and go to Development tab.
5. Click Add.
6. Fill in the required details.
7. Click Save. Your account is created and will be available in the development company page.
8. Click the required development company from the listing page. You will be redirected to the development company in the Fynd Commerce.

---

1. Install FDK CLI

The FDK CLI simplifies theme and extension development using commands for creating, testing, and deploying projects. For more details, refer to the GitHub documentations↗.

• Run the following command in your terminal to install FDK CLI:

npm install -g @gofynd/fdk-cli

note

You can run fdk --version to check if FDK CLI is successfully installed.

2. Generate a Boilerplate

1. Run the following command to log into your Fynd Partner account:

fdk login

2. Select the account for which you want to create the extension.

note

After login, you can run fdk user to verify if you've logged in.

3. Go back to your terminal and run the following command to initialise a new extension:

fdk extension init

4. Select Create new extension.

5. Enter a name for your extension.

6. Select the extension type as Private.

7. Select your preferred technology stack for the template.
   We recommend building with Node + React.js + SQLite.

info

The fdk extension init command creates a folder in your local system and downloads the boilerplate for you to get started. This command also registers a "Company Level" extension in the Fynd Partner's account. You can change all the extension details in the Partners panel.

The boilerplate contains your API credentials and takes care of authentication into Fynd Commerce for using the Platform API, Storefront API, and webhooks.

3. Populate Test Data

1. Run the following command to navigate to the extension directory:

cd "extension-name"

2. Run the following command:

fdk populate

3. Select your development company.

note

The fdk populate command adds a predefined set of products to the selected development company. This can be done only once per development company. However, if preferred, you can also create the products manually.

4. Preview Your Extension

1. Run the following command:

fdk extension preview

2. Copy the preview URL from your terminal into the browser.

3. Click Accept and Continue.

🏆Congratulations!

You've successfully created and launched your first extension.

Next Steps

Explore the Extension Development Guide to understand the how boilerplate code works, learn about our Platform API, Storefront API, Webhooks, and Bindings.