Skip to content

Commit 61aefd1

Browse files
committed
First Draft
1 parent 0f50a2f commit 61aefd1

File tree

6 files changed

+62
-0
lines changed

6 files changed

+62
-0
lines changed
Loading
Loading
Loading
Loading
Loading
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: Custom Templates
3+
description: Learn how to use the custom templates feature, allowing you to easily recreate one of your existing projects, either for yourself or for sharing with the community.
4+
author: Jacob Hylén
5+
tags: [Arduino Cloud, templates]
6+
---
7+
8+
The **Custom Templates** feature is a part of the Arduino Cloud that allows you to create your own custom cloud templates, letting you configure a project complete with a Thing, Dashboard, and Triggers with a step by setup wizard guiding you through the process.
9+
10+
With the Custom Templates feature, you can choose any of your existing cloud projects and walk through the process of turning it into a template within a few minutes. You can save it for you to use yourself, or export it as a `.tino` file to be shared with other people however you want.
11+
12+
## Hardware & Software Needed
13+
To follow this guide, you will need:
14+
- An Arduino Cloud compatible board
15+
- An Arduino Cloud Project to turn into a template
16+
17+
## Create Your Project
18+
First - we need our starting point. You may already have used the Arduino Cloud to create a project, if so you can go ahead with what you have already made.
19+
20+
For the purposes of this guide, we'll use an example project that displays one of a few icons on the LED Matrix of an Arduino UNO R4 WiFi that you can choose from a selector widget.
21+
22+
![Icon Selector](./assets/ISDashboard.png)
23+
24+
## Creating the Template
25+
Now that we have a project that we want to turn into a template, let's get started.
26+
27+
Go to the landing page of [Arduino Cloud](app.arduino.cc). In the sidebar to the left, find the button that says **Templates**.
28+
29+
![Templates](./assets/cloudinterfacetemplates.png)
30+
31+
Click into this page, and you should see that at the top there are two tabs, labelled "**Your Templates**" and "**Arduino Templates**", make sure you are in the one labelled "**Your Templates**". This is the tab that contains all the custom templates you've either made before or imported from a `.tino` file.
32+
33+
Click Create in the top right, then Choose "New Template".
34+
35+
![New Template](./assets/newtemplate.png)
36+
37+
### Selecting a Thing
38+
Now you should be taken to a new screen, where you add your Iot assets. Let's start with the Thing.
39+
40+
Click "Thing" on the right side of the screen.
41+
![Choose thing](./assets/selectingThing.png)
42+
43+
Then search for the Thing that you want to add to your template. "Icon Selector" in the case of this guide. Click your Thing, then "Add to Template".
44+
45+
46+
### Selecting a Dashboard
47+
Now do the same for the Dashboard.
48+
49+
You may see a small prompt suggesting you to add a dashboard that was already associated with the Thing you're creating the template around, you can use this as a shortcut if you want to. Otherwise follow the same flow as for selecting your Thing.
50+
51+
### Additional Documentation
52+
Now you may want to add a little bit more documentation for your project, such as a short description or images of schematics, wiring diagrams, and such. For the Icon Selector project there is no external circuit built around the board, so we're just going to write a small description, as such:
53+
54+
![Additional Documentation](./assets/description.png)
55+
56+
Once you've completed your template, click "Generate Template" and you're fininshed!
57+
58+
## Exporting Your Template
59+
Once you're back on the Templates page, you can export the `.tino` file to be used by others by clicking the three dots on the side, and clicking "download (.tino)". This will start downloading the file that you can share with the community to let others recreate your project.
60+
61+
## Conclusion
62+
In this article we've gone over how to use the **Custom Templates** feature of the Arduino Cloud to generate our own Cloud Templates that we and others can use to quickly recreate several instances of the same project.

0 commit comments

Comments
 (0)