i
IoTSpark
Back

Quick Start

From the welcome link to a running project, or creating a new project yourself in minutes.

Starting from a Welcome Link (new users)

When you click a "welcome" link (for example, received via a registration email), in the form /workspace/projects/{slug}/quick-test?welcomeToken={token}, the system automatically prepares everything for you — no need to create a project yourself or configure MQTT.

Steps

  1. Click the welcome link you received. The screen shows "Initializing project...".

Result (automatic, no further action needed):

  • The system creates 1 clone of the sample project, named in the form "{Original Project Name} (Copy)".
  • It automatically creates 1 personal MQTT connection shared across your account, and 1 MQTT connection dedicated to the cloned project.
  • The browser automatically navigates to the URL of the new cloned project, going straight to Step 1 of the Quick Test Wizard (see the article "Quick Test Wizard — 3 steps to flash firmware onto a real board").
  1. Continue through the same 3 steps of the Quick Test Wizard. The only difference: at Step 3, the system automatically builds the firmware as soon as you enter the step (no need to click the Build button).

Additional result (only for projects from a welcome link): after flashing firmware successfully, a separate box shows the IoT Dashboard initialization status:

  • In progress: "Initializing IoT Dashboard, you can monitor the data sent from the device to the cloud in real time."
  • Done: a "Open IoT Dashboard" button that goes straight to the dashboard already created for the device.
  • Error (does not block the main flow): the Serial Monitor and firmware still work normally even if the dashboard could not be created.

Example

A new user receives a welcome email containing a welcome link for the sample project "Room Temperature & Humidity Monitoring Station." Just by clicking the link, wiring according to the diagram shown, and plugging in the board — without needing to know what MQTT is or create a project themselves — they end up with a working temperature/humidity dashboard within a few minutes.