Projects
A project is one thing you're building with Palpable. It groups the boards it uses, the script that makes it work, its displays and its own chat with PAL.
Why projects?
Imagine you have two things going on:
- A greenhouse monitor with temperature and soil sensors
- A workshop alert with a distance sensor and a buzzer
Each one is its own project:
| Greenhouse Monitor | Workshop Alert | |
|---|---|---|
| Boards | A Pi with temperature and soil sensors | A board with a distance sensor and buzzer |
| Script | "Tell me when the soil is dry" | "Buzz when someone comes close" |
| PAL chat | Knows about your plants | Knows about your workshop |
Starting a project
- Choose New project in the app.
- Pick the board it should use.
- Describe what you want to build, or pick one of the ideas the app suggests for your modules. Surprise me offers wilder ones.
PAL makes the project and writes its script.
Running a project
A project runs only when you press Run at the top of the project. Press it again to stop.
On a Raspberry Pi or the UNO Q, the script runs on the board and keeps running offline. On an ESP32 board it needs the connection for now.
What's inside a project
Boards
A project can use one or more boards. Change which ones under the project menu (⋯) → Manage devices. A board can belong to more than one project.
Script
The script is what the project does. PAL writes it and changes it when you ask.
Displays
If a board in the project has a display, you'll see a live preview. Tap it to open the Display Editor.
PAL chat
Tap Ask PAL inside the project. PAL knows that project's boards, modules and script, so the conversation stays about what you're building there.
Some projects also have a Project PAL: a PAL that lives in the project, with its own tab in the chat. It's optional; PAL adds one only when a project calls for it. See Meet PAL.
Access
The project menu (⋯) has Access: who and what can reach the project. That is where you invite people and connect your own apps with an API key.
Tips
- One project per thing you're building. You can always reorganize later.
- Use descriptive names. "Living Room Climate" is better than "Project 1."
- Connect your modules first. PAL builds with the hardware it can see.