Skip to content

loyal-labs/loyal-webapp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Loyal

Fully private, on-chain AI platform built on Solana.

What is Loyal?

Loyal is a web application that provides AI chat capabilities with wallet-aware identity and private compute infrastructure. The desktop frontend currently focuses on the live chat experience rather than persisted on-chain conversation storage.

Better Stack Badge

Key Features

  • Private AI UX: Wallet-aware chat experience backed by Loyal services
  • Solana Wallet Integration: Sign in with Phantom, Solflare, and other Solana wallets
  • Automated Workflows: AI-powered task automation on Solana

Tech Stack

  • Framework: Next.js 15 (App Router, React 19)
  • Blockchain: Solana (web3.js, Anchor)
  • Styling: Tailwind CSS, Framer Motion
  • Code Quality: Ultracite (Biome preset)

Getting Started

Prerequisites

  • Node.js 20+
  • Bun, npm, yarn, or pnpm

Installation

# Install dependencies
bun install

# Run development server
bun dev

Open http://localhost:3000 to view the app.

Environment Variables

Create a .env.local file with required API keys (see .env.example).

Wallet auth and wallet session refresh are fully owned by this frontend. The local auth surface is:

  • POST /api/auth/wallet/challenge
  • POST /api/auth/wallet/complete
  • GET /api/auth/session
  • POST /api/auth/session/refresh
  • POST /api/auth/logout

Wallet sign-in provisions or reconciles the sponsored smart account before the session cookie is issued. The HttpOnly wallet session cookie uses a 7 day TTL and refreshes locally once it is at least 24 hours old.

Development

# Development server
bun dev

# Build for production
bun run build

# Start production server
bun start

# Lint code
bun run ultracite

Project Structure

src/
├── app/              # Next.js app router pages
├── components/       # React components
├── lib/              # Core libraries and transport helpers
├── hooks/           # React hooks
└── data/            # Static data and content

Links

Status

⚠️ Early Stage Product: This is an open test version. Features may be incomplete or contain errors.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE.md file for details.

What this means

  • ✅ You can use, modify, and distribute this software
  • ✅ If you run a modified version on a server, you must make the source code available to users
  • ✅ Any modifications must also be licensed under AGPL-3.0
  • ✅ This ensures the software remains free and open source

About

Mirror of loyal-app/frontend

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages