Skip to content
Select documentation version
Navigation
On this page

Use Cases and Examples

When Watt Excels: Real-World Scenarios

Watt transforms complex Node.js application development into a unified experience. Here are the scenarios where Watt delivers the most value and the practical examples that demonstrate its capabilities.


Quick Decision Guide

Perfect Fit for Watt

Full-Stack Web Applications

  • Next.js, Astro, or Remix frontends with Node.js APIs
  • Service-driven applications with complex business logic
  • Need unified deployment of frontend and backend

Microservices as Modular Monoliths

  • Multiple services that should deploy together
  • Team wants microservices benefits without operational complexity
  • Need service-to-service communication without network overhead

Legacy Modernization

  • Existing Express, Fastify, or Node.js applications
  • Need to add modern tooling (observability, auto-generated APIs, etc.)
  • Want gradual migration to modern architecture

Consider Alternatives When

Polyglot Requirements

  • Need non-Node.js services (Python ML models, Java services, etc.)
  • Team expertise is primarily in other languages
  • Existing investment in non-Node.js infrastructure

True Service Independence

  • Services need completely independent deployment cycles
  • Different services have drastically different scaling requirements
  • Organizational boundaries require strict service isolation

Heavily Container-Orchestrated Environments

  • Deep investment in Kubernetes-native patterns
  • Need fine-grained resource allocation per service
  • Complex multi-region deployment requirements

Industry Use Cases

E-Commerce and Retail

Scenario: Multi-tenant e-commerce platform with product catalog, user management, and order processing

┌──────────────────────────────────────────────────────────────────┐
│                                Watt Application                  │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │  Gateway     │ │  Storefront │ │  Admin      │ │ Customer    │ │
│ │ (Entrypoint) │ │  (Next.js)  │ │ Dashboard   │ │   API       │ │
│ │              │ │             │ │ (React)     │ │(Fastify)    │ │
│ └──────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│                  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│                  │  Products   │ │   Orders    │ │ Payments    │ │
│                  │    API      │ │     API     │ │ Integration │ │
│                  │  (Express)  │ │  (Fastify)  │ │ (Service)   │ │
│                  └─────────────┘ └─────────────┘ └─────────────┘ │
└──────────────────────────────────────────────────────────────────┘

Why Watt Works:

  • Unified deployment reduces complexity from 6+ containers to 1
  • Fastify-based APIs accelerate product catalog and order management
  • Service-level authorization handles multi-tenant data isolation
  • Shared logging provides unified view of customer journey

SaaS Applications

Scenario: Project management SaaS with user workspaces, real-time collaboration, and analytics

┌────────────────────────────────────────────────────────────────┐
│               Watt SaaS Platform                               │
├────────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │
│ │  Gateway     │ │  Frontend   │ │ WebSocket   │ │ Analytics │ │
│ │ (Entrypoint) │ │  (Remix)    │ │  Service    │ │ Dashboard │ │
│ │              │ │             │ │ (Real-time) │ │  (Vite)   │ │
│ └──────────────┘ └─────────────┘ └─────────────┘ └───────────┘ │
│                  ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │
│                  │ Projects    │ │   Users     │ │  Billing  │ │
│                  │    API      │ │     API     │ │    API    │ │
│                  │ (Fastify)   │ │  (Fastify)  │ │ (Service) │ │
│                  └─────────────┘ └─────────────┘ └───────────┘ │
└────────────────────────────────────────────────────────────────┘

Why Watt Works:

  • GraphQL subscriptions enable real-time features
  • Service-level security provides workspace isolation
  • Built-in metrics track user engagement and system health
  • Single deployment simplifies compliance and monitoring

Example Configuration:

// Fastify service with workspace isolation
export default async function  (app) {
  app.register(async function (app) {
    app.get('/projects', async (request, reply) => {
      const workspaceId = request.headers['workspace-id']
      // Handle workspace-scoped project retrieval
      return { projects: await getProjectsByWorkspace(workspaceId) }
    })
  })
}

Enterprise Applications

Scenario: Internal employee portal with HR systems, document management, and approval workflows

┌────────────────────────────────────────────────┐
│          Enterprise Employee Portal            │
├────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │
│ │  Portal     │ │ Document    │ │   HR       │ │
│ │  Frontend   │ │ Viewer      │ │ Dashboard  │ │
│ │  (Astro)    │ │             │ │            │ │
│ └─────────────┘ └─────────────┘ └────────────┘ │
│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │
│ │   Legacy    │ │ Workflows   │ │   Auth     │ │
│ │    HR       │ │    API      │ │ Service    │ │
│ │ Integration │ │ (Fastify)   │ │ (LDAP/SSO) │ │
│ └─────────────┘ └─────────────┘ └────────────┘ │
└────────────────────────────────────────────────┘

Why Watt Works:

  • Legacy integration through service wrappers
  • Enterprise SSO/LDAP authentication built-in
  • Audit logging and compliance reporting
  • Gradual migration from monolithic systems

Fintech and Financial Services

Scenario: Personal finance app with banking integration, transaction processing, and reporting

┌──────────────────────────────────────────────────┐
│             Fintech Application                  │
├──────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │   Mobile     │ │   Web       │ │ Reports     │ │
│ │   App        │ │   App       │ │ Engine      │ │
│ │  (API)       │ │ (Next.js)   │ │(Service)    │ │
│ └──────────────┘ └─────────────┘ └─────────────┘ │
│ ┌──────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Transactions │ │ Accounts    │ │  Banking    │ │
│ │     API      │ │   API       │ │ Integration │ │
│ │  (Fastify)   │ │ (Fastify)   │ │  (Plaid)    │ │
│ └──────────────┘ └─────────────┘ └─────────────┘ │
└──────────────────────────────────────────────────┘

Why Watt Works:

  • PCI compliance through unified logging and monitoring
  • Real-time transaction processing with event-driven architecture
  • Bank-grade authorization and audit trails
  • Single deployment reduces compliance surface area

Architecture Patterns

Pattern 1: API-First Applications

Best For: Mobile apps, third-party integrations, microservices consumers

Architecture:

┌──────────────┐    ┌──────────────────────────────────┐
│   Client     │───▶│          Watt App                │
│ Applications │    │ ┌────────────┐  ┌──────────────┐ │
└──────────────┘    │ │ Fastify    │  │  Gateway     │ │
                    │ │  Service   │  │ (Entrypoint) │ │
┌──────────────┐    │ │            │  │              │ │
│  Third-Party │───▶│ └────────────┘  └──────────────┘ │
│ Integrations │    │ ┌────────────┐  ┌────────────┐   │
└──────────────┘    │ │ Business   │  │  Auth      │   │
                    │ │  Logic     │  │ Service    │   │
                    │ │ (Service)  │  │            │   │
                    │ └────────────┘  └────────────┘   │
                    └──────────────────────────────────┘

Key Benefits:

  • OpenAPI documentation
  • Built-in rate limiting and authentication
  • Unified API versioning and deprecation
  • Client SDK integration

Pattern 2: Full-Stack Web Applications

Best For: Customer-facing web apps, content management systems, dashboards

Architecture:

┌──────────────┐    ┌──────────────────────────────┐
│   Browser    │───▶│          Watt App            │
│              │    │ ┌────────────┐  ┌──────────┐ │
└──────────────┘    │ │ Frontend   │  │   API    │ │
                    │ │  (Next.js/ │  │ Services │ │
                    │ │  Astro/    │  │          │ │
                    │ │  Remix)    │  │          │ │
                    │ └────────────┘  └──────────┘ │
                    │ ┌────────────┐  ┌──────────┐ │
                    │ │ Fastify    │  │  Assets  │ │
                    │ │  Service   │  │ (Static) │ │
                    │ │            │  │          │ │
                    │ └────────────┘  └──────────┘ │
                    └──────────────────────────────┘

Key Benefits:

  • Server-side rendering with API co-location
  • Unified authentication across frontend and API
  • Shared configuration and environment variables
  • Single domain, no CORS complexity

Pattern 3: Event-Driven Systems

Best For: Real-time applications, IoT data processing, workflow automation

Architecture:

┌──────────────┐    ┌─────────────────────────────────┐
│  External    │───▶│           Watt App              │
│  Events      │    │ ┌─────────────┐ ┌────────────┐  │
└──────────────┘    │ │   Event     │ │ Processors │  │
                    │ │  Gateway    │ │  (Workers) │  │
┌──────────────┐    │ │             │ │            │  │
│  Webhooks    │───▶│ └─────────────┘ └────────────┘  │
└──────────────┘    │ ┌─────────────┐ ┌─────────────┐ │
                    │ │   Event     │ │   State     │ │
                    │ │   Store     │ │  Manager    │ │
                    │ │ (Fastify)   │ │ (Fastify)   │ │
                    │ └─────────────┘ └─────────────┘ │
                    └─────────────────────────────────┘

Pattern 4: Legacy Modernization

Best For: Migrating existing applications, gradual architecture evolution

Architecture:

┌──────────────┐    ┌─────────────────────────────────┐
│   Clients    │───▶│           Watt App              │
│              │    │ ┌─────────────┐ ┌─────────────┐ │
└──────────────┘    │ │   Modern    │ │   Legacy    │ │
                    │ │   Frontend  │ │   App       │ │
                    │ │  (Next.js)  │ │ (Express)   │ │
                    │ └─────────────┘ └─────────────┘ │
                    │ ┌─────────────┐ ┌─────────────┐ │
                    │ │    New      │ │   Legacy    │ │
                    │ │    APIs     │ │ Database    │ │
                    │ │ (Fastify)   │ │ (Wrapped)   │ │
                    │ └─────────────┘ └─────────────┘ │
                    └──────────────── ────────────────┘

Example Applications

1. E-commerce Store

Conceptual Example: Full-stack e-commerce application pattern

Features:

  • Product catalog with search and filtering
  • Shopping cart and checkout process
  • Admin dashboard for inventory management
  • Customer authentication and profiles

Architecture Pattern:

{
  "applications": [
    { "path": "./storefront", "id": "storefront" },
    { "path": "./admin", "id": "admin" },
    { "path": "./products", "id": "products" },
    { "path": "./orders", "id": "orders" },
    { "path": "./auth", "id": "auth" }
  ]
}

2. Content Management System

Conceptual Example: Multi-tenant content management pattern

Features:

  • Content authoring with rich text editor
  • Multi-site content management
  • API-driven content delivery
  • User roles and permissions

GraphQL Query Pattern:

// GraphQL APIs
query GetPosts($siteId: ID!) {
  posts(where: { siteId: { eq: $siteId } }) {
    id
    title
    content
    publishedAt
    author {
      name
      email
    }
  }
}

3. Real-time Chat Application

Conceptual Example: WebSocket-powered messaging system

Features:

  • WebSocket-based real-time messaging
  • Channel management and user presence
  • Message history and search
  • File sharing capabilities

Real-time Pattern:

// GraphQL subscriptions for real-time updates
subscription MessageAdded($channelId: ID!) {
  messageAdded(channelId: $channelId) {
    id
    content
    author {
      name
    }
    timestamp
  }
}

4. Analytics Dashboard

Conceptual Example: Time-series data processing system

Features:

  • Time-series data collection
  • Interactive charts and visualizations
  • Custom report generation
  • Data export capabilities

Service Pattern:

// Fastify service for analytics data processing
export default async function  (app) {
  app.register(async function (app) {
    app.get('/events', async (request, reply) => {
      // Handle time-series data retrieval
      return { events: await getEvents(request.query) }
    })
  })
}

Next Steps

Choose your path based on your use case:

Start Building Immediately

Deep Dive into Architecture

Migrate Existing Applications

Production Deployment

Reading time
7 min read
View as
Markdown
Contribute
Edit this page