Docs
Browse topics

Applets

What applets are, the difference between resource and tool applets, and how to add them to a project.

Applets are the building blocks of RightPlace. Everything that lives as a tab in your project - a WordPress site, a database connection, a terminal, a code editor, a web browser - is an applet. There are two kinds.

Resource applets

A resource applet is a persisted connection to something outside the app. You add it once (a WordPress site URL, a database DSN, a docs folder) and it stays in your project across tabs and sessions. Opening a resource applet always reopens the same saved instance.

Examples: WordPress, Database, Docs, Agent Team, SFTP, Object Storage.

Resource applets are where project configuration lives. If you need agents, scripts, or automations to reach a system later, save it as a resource.

Tool applets

A tool applet is an ephemeral session you launch from the New Tab page. Nothing is saved. Use it, close the tab, move on. The next time you need one you start a fresh session.

Examples: Browser, File & Media Explorer, WordPress Global Dashboard.

Tool applets are for quick work that does not need to persist.

Applets that are both

A handful of applets are usable as either a resource or a tool. For example, the Terminal applet can be saved as a resource (a named session tied to a project) or launched ad-hoc as a tool. Same component, two entry points.

Examples: Terminal, Code Editor, Image Editor, Git, HTML Playground.

How to add an applet

  1. Open the project where you want the applet.
  2. Click Add Resource in the sidebar, or hit the shortcut on the New Tab page.
  3. Pick a category (Web & CMS, Development, AI & Agents, Operations, Content, Data & Storage, Infrastructure).
  4. Pick the applet you want.
  5. Fill in whatever the applet needs (a URL, a folder, credentials) and confirm.

The applet appears in the sidebar and opens in a new tab. Tools skip step 4: just open a new tab and pick from the Tools row at the top of the New Tab page.

Browse the catalog

Every built-in applet has its own page with docs, features, and screenshots. See the full list at /applets.

Build your own

Applets are not a closed list. The same SDK that ships the built-in WordPress, Database, and Docs applets is available to anyone who wants to add a new one. A custom applet can be a resource (a saved connection with its own settings page, background sync, and widgets) or a tool (a launcher and an ephemeral session UI). You ship it as a RightPlace add-on, install it into any project, and it behaves like the built-ins.

Start here:

  • Custom Resources overview walks through the core concepts - manifest, frontend panels, backend hooks, permissions.
  • Getting Started is the hands-on quickstart: scaffold an applet, wire it into a project, iterate locally.
  • Frontend SDK covers the React components and hooks you use to render the applet UI.
  • Hooks documents the filter and action APIs your applet can listen on or emit.

If you end up with something worth sharing, the Community tab on /applets is where it lands.