Cloud App
🚀 New to DEJA Cloud? Start with the interactive Cloud Guide for a visual walkthrough of every feature.
The Cloud app is the central configuration hub for your DEJA.js model railroad layout. It provides a web-based interface for managing every aspect of your layout -- from building your locomotive roster to wiring signals and configuring hardware devices. All configuration data is stored in Firebase and synchronized in real time across all connected apps.
What You Can Do
The Cloud app covers the full lifecycle of layout configuration:
- Locomotive Roster -- Add, edit, and remove locomotives. Configure DCC addresses, decoder functions (F0 through F28), and build multi-unit consists.
- Sound Library -- Upload, browse, preview, and delete sound files. Files are stored in Vercel Blob and served via API endpoints.
- Turnouts -- Define turnout names, DCC indices, pin assignments, and device bindings. Organize them with tags, reorder with drag-and-drop sorting.
- Routes -- Create automated turnout sequences that throw multiple turnouts in a defined order with a single action.
- Effects -- Set up lights, LEDs, street lights, relays, sound effects, macros, addressable LED strips (IALED), and more.
- Signals -- Wire three-aspect signal heads (red, yellow, green) with per-pin configuration and common anode/cathode wiring selection.
- DCC-EX Console -- Send raw DCC commands to the CommandStation, use preset command buttons, and monitor command history in real time over WebSocket.
- Layout Configuration -- Manage devices, view serial ports, review loaded firmware modules, and organize layout metadata with tags.
- Sensors -- Monitor real-time sensor state from connected hardware.
- Upgrade -- View subscription plans and upgrade to access premium features.
Authentication and Access
The Cloud app requires authentication. Users can sign up with email and password, or sign in with GitHub OAuth. After signing up, new users go through a five-step onboarding wizard:
- Create Account -- Sign up and verify your identity.
- Choose Plan -- Select Hobbyist (free), Engineer, or Conductor.
- Payment -- Enter payment details for paid tiers (skipped for Hobbyist).
- Register Layout -- Name your layout and choose a unique layout ID.
- Install -- Get the personalized install command for the DEJA Server, pre-populated with your UID and layout ID.
After onboarding, users are taken to a Setup Complete page that confirms layout creation, offers a quick-add form for their first locomotive, and provides the server install command again. Layouts are automatically approved on creation -- there is no admin approval step.
Users then select a layout to work with. The selected layout ID is persisted in local storage (@DEJA/layoutId) so it carries across sessions.
Navigation
The Cloud app uses a sidebar navigation drawer to move between sections. The menu items, from top to bottom, are:
| Section | Icon | Description |
|---|---|---|
| Layout | Fence | Hardware devices, serial ports, firmware modules, and tags |
| DCC-EX | CPU | Raw command console and real-time command log |
| Roster | Train | Locomotive management with functions and consists |
| Effects | Rocket | Lights, sounds, LEDs, macros, and IALED strips |
| Turnouts | Call Split | Turnout configuration with sorting and filtering |
| Routes | Map | Automated turnout sequences |
| Signals | Traffic Light | Three-aspect signal head wiring |
| Settings | Cog | User preferences |
The header bar displays the app name ("Cloud"), a cloud icon, and provides controls for track power, emergency stop, device status indicators, and user profile access.
Dashboard
The home screen serves as a system overview. If a DCC-EX CommandStation device is configured in your layout, the dashboard displays a live device status list showing connection state, port assignments, and health indicators for each connected device.
If no DCC-EX device has been configured yet, the dashboard shows an onboarding prompt titled "Set Up Your Command Station" with quick-links to layout setup. This empty state highlights three key capabilities: monitoring layout status, tracking connected devices, and viewing a system health overview.
Changes made in the Cloud app are immediately visible in the Throttle, Monitor, and Tour apps — all data syncs in real time.
Accessing the Cloud App
The Cloud app is available at cloud.dejajs.com. Log in with your DEJA Cloud account and select a layout to get started.
Next Steps
- Cloud Guide -- Interactive visual walkthrough of every feature.
- Locomotive Roster -- Add and configure your locomotives.
- Devices -- Register and manage hardware controllers.
- Connect -- Manage live connections to your hardware.
- Turnouts -- Define and organize your layout switches.
- Effects -- Set up lights, sounds, LEDs, and macros.
- Signals -- Wire three-aspect signal heads.
- Routes -- Create automated turnout sequences.
- Sensors -- Monitor sensors and build automation rules.
- Layout Configuration -- Tags, ports, modules, and layout metadata.
- DCC-EX Console -- Send commands directly to your CommandStation.
- Settings -- Account, theme, subscription, and server config.