Guides

Solve a Task

Guides provide focused, task-oriented steps for common Scalive development and operations work. For an ordered introduction to the framework, start with Learn. Each guide describes the starting state it expects so you can also enter directly from search or the API reference.

Orientation

• Phoenix LiveView concepts in Scalive maps Phoenix concepts to Scalive's Scala-first API without assuming complete parity.

Setup And Foundations

• Client setup and static assets loads the packaged Phoenix clients or a custom bundle, serves an ordinary versioned tree or manifest-defined final paths, and reacts to static changes and connection parameters.

Interfaces And Input

• HTML and event bindings builds typed trees, composes token-list attributes, binds messages, keys repeated content, and uses portal and focus-management helpers.

• Typed forms and validation decodes rooted browser input into domain values with recovery, stable repeated rows, path-specific feedback, and revision-bound save coordination.

• Ordinary HTTP forms and redirects combines checked actions, bounded CSRF-protected decoding, trigger-action handoff, and HTTP-to-Live flash.

• File uploads validates bounded files and chooses in-memory, hosted-writer, or external destination ownership.

Routing And Application Structure

• Routes, parameters, and navigation decodes typed URL state and chooses checked patch, navigation, replace, and redirect behavior.

• Layouts, live sessions, and mount aspects composes document shells, route groups, and typed pre-mount policy.

• Services and dependency injection constructor-injects application capabilities while keeping socket state connection-local.

• Authentication and sessions combines ordinary HTTP login and reset with opaque sessions and protected LiveView mounts.

State And Components

• Stateful components and communication isolates local state, maps typed outputs, and owns component-local features.

• Nested LiveViews embeds an independently mounted child with explicit socket, navigation, crash, and sticky-lifecycle ownership.

• Streams and collection updates separates durable collection state from targeted, bounded DOM operations.

Async And Lifecycle

• Asynchronous work, subscriptions, and connected resources owns finite tasks, long-lived message streams, and other acquired resources with lifecycle cleanup.

• Lifecycle hooks guards complete connected turns and applies ordered static or dynamic policy to individual lifecycle stages.

• Lifecycle feedback and page state owns flash, document titles, connection feedback, and post-render observation.

Browser Integration

• Browser commands, events, and hooks composes client effects and implements validated, registered JavaScript hooks.

• Guard unsaved changes installs the framework browser runtime and confirms browser-initiated navigation while rendered state is dirty.

Testing And Troubleshooting

• Testing LiveViews covers public disconnected and connected server-side tests, then identifies behavior that requires a real browser.

• Troubleshooting diagnoses startup, asset, socket, CSRF, crash, and reconnect failures.

Assets And Operations

• Configuration configures transport security, route-level lifecycle observation, and setting ownership.

• Lifecycle observability publishes fixed ZIO metrics and defines safe logging, tracing, labels, and coverage boundaries.

• Deployment packages and operates a Scalive JVM application behind HTTPS and a WebSocket-capable edge.