@reltio/app

The Reltio application CLI. Scaffold and maintain a runnable Next.js App Router app wired to @reltio/design and @reltio/auth.

# Scaffold a new app into ./my-app
npx @reltio/app create my-app

# (planned) refresh the platform-managed files of an existing app
npx @reltio/app update

create prompts for anything you omit (app name, dependency install, git init), then:

cd my-app
cp .env.local.example .env.local   # fill in your Reltio OAuth client
npm run dev

Commands

What create gives you (v1)

The v1 starter focuses on the authentication flow so you have a working, secure foundation to build on:

• Reltio OAuth login / logout / callback via @reltio/auth mounted at app/auth/[...auth]/route.ts.
• Route gating through proxy.ts (Next.js Proxy, formerly Middleware) — unauthenticated visitors are sent to the Reltio Login Page.
• A protected page that proves the session: it reads the introspected token server-side and shows the signed-in user's username / email and their real Reltio tenants, plus a Logout button.
• @reltio/design's ShellBar + UserMenu chrome and its variables.css linked for SAP Horizon base styling (data-theme="sap-reltio-light").

Richer UI (app switcher, a BFF proxy to Reltio REST APIs, example data pages, theming/dark mode) is intentionally left out of v1 and added later as separate features.

Configuration

Set these in .env.local (see .env.local.example):

License

Licensed under the Apache License, Version 2.0. See NOTICE for attribution.