# Sample Code

## A prototype in 2 minutes <a href="#a-prototype-in-2-minutes" id="a-prototype-in-2-minutes"></a>

Using this simple, client-side example, you can literally try out Beefree SDK in 2 minutes…

1. Obtain your application keys (**Client ID** and **Client Secret**) [by signing up here](https://dam.beefree.io/devportalsignup) (there is a free plan).
2. Create a new application: you will find your keys in the project’s details page
3. [Download](https://dam.beefree.io/pluginsamplecode) the client-side sample code.
4. Open `index.html` with your favorite code editor
5. Locate `client_id` and replace **“YOUR\_CLIENT\_ID”** with yours
6. Locate `client_secret` and replace **“YOUR\_CLIENT\_SECRET”** with yours
7. Save the file
8. Open it in your browser and get creative ![(smile)](https://mailup.atlassian.net/wiki/s/en_GB/6105/7d738a52bdb6676b96419199dc18454c6082dfc5.26/_/images/icons/emoticons/smile.png)

## Embedding the builder <a href="#embedding-the-builder" id="embedding-the-builder"></a>

Before using the code samples listed below in a production environment, please consider the following:

1. Make sure you first [sign up](https://dam.beefree.io/devportalsignup) and get your application keys (**Client ID** and **Client Secret**).
2. The client-side sample is not safe for a production environment (it was conceived as a quick way for you to test the application). Someone would be able to easily steal your application credentials (just viewing the source code of the page). To keep those credentials safe, authorization must be managed sever-side, as the .NET sample does.
3. These code samples use a limited set of features and configurations: they can be a good starting point to start developing around Beefree SDK, but they are not an exhaustive showcase of everything you can do.
4. All sample code is provided “as is”: it may contain defects, it may not follow best practices (although we try to!), and it should only be considered as point of reference.

## GitHub Repositories <a href="#embedding-the-builder" id="embedding-the-builder"></a>

| Name and Link                                                                                               | Description                                                                                                                      | Stack                  |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| [SDK Sample: Full-stack NextJS App](https://github.com/BeefreeSDK/beefree-sdk-sample-nextjs)                | Demonstrates integrating the Beefree SDK into a full-stack NextJS application with database integration and user authentication. | NextJS, Python, SQLite |
| [Beefree SDK: Official NPM Package](https://github.com/BeefreeSDK/beefree-sdk-npm-official)                 | The official NPM package for Beefree SDK, complete with installation instructions and configuration tips.                        | Typescript             |
| [SDK Webinar: Saved and Synced Rows](https://github.com/BeefreeSDK/beefree-sdk-demos)                       | Code from our latest webinars showcasing how to use Saved and Synced Rows feature within the Beefree SDK.                        | ReactJS                |
| [Beefree SDK: Email and Landing Page Templates](https://github.com/BeefreeSDK/beefree-sdk-assets-templates) | A collection of free email, landing page, and popup templates designed for easy integration with the Beefree SDK.                | JSON                   |
| [SDK Sample: Simple Client HTML App](https://github.com/BeefreeSDK/beefree-sdk-sample-client)               | A simple HTML app demonstrating the basic implementation of the Beefree SDK for client-side applications.                        | HTML, JavaScript       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.beefree.io/beefree-sdk/~/changes/3EjxmC5rAYEIQ0JKR16k/getting-started/sample-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
