Blux Docs

Blux is wallet infrastructure for Stellar dApps — designed to make onboarding seamless, even for users who don't have a Stellar wallet.

Users can sign in instantly with email, social accounts (Google, Apple, and more), passkeys, or an existing wallet. No friction, no setup, no barriers.

What's Included

Multiple Auth Methods

Email, social, passkeys, and wallets — all out of the box.

Built-in Hooks

Transaction signing, balances, swap, history, and on/off-ramp modals.

Customizable UI

Match your dApp's branding with a fully configurable modal.

TypeScript Ready

Full type safety with clean, modern APIs.

The only required config is your App ID. Leave out networks and the app uses Mainnet. Leave out appName and Blux uses "App". Everything else — appearance, login methods, language, wallets — has defaults too.

npm install @bluxcc/react

import { BluxProvider, useBlux } from "@bluxcc/react";

function App() {
  const { login, isAuthenticated } = useBlux();

  return (
    <button onClick={login}>
      {isAuthenticated ? "Connected" : "Connect"}
    </button>
  );
}

export default function Root() {
  return (
    <BluxProvider
      config={{
        appId: "your-app-id",
      }}
    >
      <App />
    </BluxProvider>
  );
}

npm install @bluxcc/core

import { createConfig, blux } from "@bluxcc/core";

createConfig({
  appId: "your-app-id",
});

document.querySelector("#connect")?.addEventListener("click", () => {
  blux.login();
});

Get an App ID from the dashboard, then follow the full setup guide for your stack:

React

For React, Next.js, Vite, and CRA projects.

JavaScript

For framework-agnostic or vanilla JS projects.

Want to see Blux in action before integrating? Try the live demo →

Introduction