Really Nais Examples

This repository contains a collection of example applications for the Nais platform. The main example is a Quotes application, where users can view and create quotes. Each service demonstrates a specific technology stack and integration pattern commonly used in modern cloud-native applications on Nais.

Another key purpose of these examples is to showcase the observability features available in the Nais Platform, based on OpenTelemetry. This includes:

• Logs collected in Loki
• Metrics collected in Prometheus
• Traces collected in Tempo

All observability data is available and visualized in Grafana, making it easy to monitor, debug, and understand your applications running on Nais.

Purpose

The purpose of this repository is to help developers understand how to:

• Build and deploy frontend, backend, and load generation services on Nais
• Integrate with managed databases (PostgreSQL)
• Use modern frameworks and best practices for cloud applications

High-Level Overview

This repository consists of the following services:

Service	Tech Stack	Purpose & Description
quotes-frontend	Next.js, React, Tailwind CSS	The web frontend for the Quotes app, allowing users to view and submit quotes. Includes analytics dashboard.
quotes-backend	Kotlin, Ktor, PostgreSQL	The backend API for the Quotes app, handling quote storage and retrieval.
quotes-analytics	.NET 8, ASP.NET Core	Analytics service that processes quote data from the backend, providing insights and custom OpenTelemetry metrics.
quotes-loadgen	Go (Golang)	A load generator for simulating traffic and testing the Quotes application.

Integration Flow

1. Users interact with the quotes-frontend (Next.js) to view and submit quotes
2. Frontend communicates with quotes-backend (Kotlin/Ktor) for quote storage/retrieval
3. Analytics service (.NET) processes quotes from the backend to provide:
   • Word count analysis
   • Sentiment scoring
   • Quote categorization
   • Custom OpenTelemetry metrics
4. Frontend displays analytics via a dedicated /analytics page
5. Load generator (Go) simulates traffic to test the entire system
6. All services send observability data (traces, metrics, logs) to the OTEL stack

Quick Start

# Start all services
docker-compose up -d

# Access the application
open http://localhost:3000          # Frontend (quotes + analytics)
open http://localhost:8080          # Backend API
open http://localhost:8081          # Analytics API
open http://localhost:3000/analytics # Analytics Dashboard
open http://localhost:3000          # Grafana (logs, metrics, traces)

For more details on each service, see the README in the respective subdirectory:

• quotes-frontend/README.md
• quotes-backend/README.md
• quotes-analytics/README.md
• quotes-loadgen/README.md

Architecture

A high-level overview of the Quotes application and its dependencies:

---
config:
  flowchart:
    defaultRenderer: elk
---
graph LR

  subgraph Browser
  A(User)
  end

  subgraph Frontend
  B(Next.js)
  end

  subgraph Backend
  C(Ktor API)
  D[(PostgreSQL)]
  end

  subgraph Analytics
  F(.NET 8)
  end

  subgraph Loadgen
  E(Go)
  end

  subgraph Observability
  G[Grafana/OTEL]
  end

  A --> B
  B --> C
  B --> F
  C --> D
  F --> C
  E --> B
  E --> F

  B -.-> G
  C -.-> G
  F -.-> G
  E -.-> G

Loading

License

The code in this repository is licensed under the MIT license. See LICENSE for more information.