Home

Atmosphere Framework 4.0

The Atmosphere Framework makes it easy to build real-time web applications using WebSocket and Server-Sent Events (SSE) with automatic fallback to long-polling. It runs on JDK 21+ and integrates with Spring Boot 4.0, Quarkus 3.21+, and any Servlet 6.0+ container.

Atmosphere 4.0 introduces first-class Rooms with presence tracking, message history, and direct messaging — plus a fully rewritten TypeScript client with React, Vue, and Svelte hooks.

Getting Started

Pick your deployment model:

• Getting Started with Spring Boot 4.0 — auto-configured, production-ready
• Getting Started with Quarkus — build-time optimized, native-image ready
• WAR Deployment (Tomcat, GlassFish, etc.) — deploy to any Servlet 6.0+ container
• Getting Started with atmosphere.js 5.0 — TypeScript client library

Core Concepts

• Understanding @ManagedService — the annotation-driven approach for general-purpose endpoints
• Understanding @RoomService — the room-aware alternative with built-in presence and history
• Understanding Rooms — named groups with presence, history, and direct messaging
• Understanding Broadcaster — the pub/sub message bus (includes cache & filters)
• Clustering with Kafka and Redis — scale out across multiple nodes

Client Library — atmosphere.js 5.0

• Getting Started with atmosphere.js 5.0 — subscribe, transports, rooms
• Framework Hooks — React, Vue, Svelte — useRoom, usePresence, stores
• atmosphere.js API Reference — full type reference

Advanced Topics

• Understanding AtmosphereResource — the server-side connection handle
• Understanding AtmosphereInterceptor — request/response pipeline
• Understanding the Atmosphere Protocol — wire format and handshake

Migration

• Migrating from Atmosphere 2.x to 4.0

Samples

Sample	Framework	Source
Chat	WAR / Embedded Jetty	samples/chat
Chat (WebSocket)	Embedded Jetty	samples/embedded-jetty-websocket-chat
Chat + Rooms	Spring Boot 4.0	samples/spring-boot-chat
Chat	Quarkus 3.21	samples/quarkus-chat

Legacy Documentation

Looking for Atmosphere 2.x documentation? See the Legacy Documentation page.