How to guides

These guides cover common Profinity 2.3 jobs, such as connecting a CAN bus adapter, building a dashboard, and logging data. Most guides list what they need first, then the steps, and link to the reference page for the feature they use. Start with the Quick start guide if Profinity is not installed yet.

Build and style dashboards

• How to create a custom dashboard: build a first dashboard for a Custom Component.
• How to add images to your dashboard: use custom images in dashboard components.
• How to style your dashboard: add a profile.css stylesheet, and apply its classes to dashboard groups and readouts.

Add components and connect devices

• How to add a component to your profile: configure a component, and add it to the active profile.
• How to connect to CAN bus: connect Profinity to a CAN bus network.
• How to send and receive CAN bus messages: view CAN traffic, and send a CAN packet once or on a schedule.
• How to replay CAN bus logs: replay recorded CAN bus messages for testing without live CAN hardware.

Log and publish data

• How to configure data logging: choose a destination for files, InfluxDB, Prometheus, Message Queuing Telemetry Transport (MQTT), or a webhook, add the logger or publisher, start it, and check that data is flowing.
• How to log data to InfluxDB: prepare InfluxDB Cloud or a self-hosted server, connect the InfluxDB v2 Historian, and check data arrives.

Configure and deploy

• How to create a new profile: set up a profile for a separate site or configuration.
• Environment variables: set a configuration value from an environment variable.
• How to set up Profinity as a kiosk application: configure Kiosk Mode, and start a fullscreen browser on Windows, Linux, or macOS.

Extend Profinity

• Connect an AI tool to Profinity: choose Claude Code, Cursor, Codex, or ChatGPT and open its setup guide.
• Make your first Custom Component: add a Custom Component with a CAN database (DBC) file, dashboard, main script, menu actions, and firmware.
• How to write your first script: enable scripting, add a script component, and run a first script.
• Script examples: read a DBC signal, send a CAN message, and keep script state.

Tags, rules, and plugins

These Profinity 2.3 features have no separate guide, and the reference pages describe them in full.

• Tag collections: group tags for logging and publishing.
• Derived tags: calculate a new tag from existing tags with an expression.
• Tag rules and Rule actions: run an action when a rule raises an alert.
• AI Skills: generate dashboards, rules, and scripts with an AI tool.
• Developing Plugins: extend Profinity with a plugin.

More help

• Prohelion Profinity 2.3: the documentation home page.
• Frequently asked questions: answers to frequently asked dashboard questions.