Full Ethora app engine, React.js version.

Part of the Ethora SDK ecosystem — see all SDKs, tools, and sample apps. Follow cross-SDK updates in the Release Notes.

This repository contains the React.js frontend for Ethora. It is the main web client used for Ethora-powered apps and includes authentication, chat and messaging flows, AI-related UI surfaces, admin/app settings, widgets, and integrations used by the wider platform.

This project was previously tracked in the Ethora monorepo under the client-web folder. It was moved into its own repository in November 2024.

This frontend is built on top of the Ethora chat component package:

• @ethora/chat-component on npm
• dappros/ethora-chat-component

• dev is the main default branch used by the team for ongoing frontend development and review.
• main is kept as a stable/public branch and may lag behind current team work.
• Feature and review branches should normally branch from dev and open PRs back into dev unless there is a specific reason to do otherwise.

Typical local workflow:

npm install
npm run dev

Useful commands:

npm run build
npm run typecheck
npm run lint

This repo also contains a Playwright e2e layer for browser-visible public routes and for the chat-component flows that mount under /app/chat. To list or run the suite:

npm run test:e2e -- --list
npm run test:e2e

This repo is the Layer 2 (browser e2e) home for chat-component. The testid constants in tests/e2e/_chatComponentTestIds.ts mirror the public testIds exported by @ethora/chat-component and match the Compose testTag / SwiftUI accessibilityIdentifier strings used by the mobile SDKs and their Maestro flows.

A Playwright spec using [data-testid="chat_input"] and a Maestro flow using id: "chat_input" resolve the same intent — one selector contract across all four runtime targets.