lily-protocol/lily-frontend

Lily Frontend is the web interface for Lily Protocol, a project focused on building finance infrastructure for autonomous AI agents on the Stellar network. Stellar is a blockchain designed for fast, low cost transactions, and this repository provides the developer facing dashboard that will let people manage the financial side of AI agents running on that network. The application is built with Next.js 16, using its App Router approach, along with React 19, TypeScript, and Tailwind CSS 4 for styling. The contributor guidelines ask developers to default to server components, only switching to client side components when interactivity is actually needed. The project also uses ESLint for code quality checks and Vitest with Testing Library for automated tests. A GitHub Actions workflow runs linting, type checking, tests, and production builds on every push and pull request, with each check set up as its own job so a failure in one area does not hide results from the others. Getting started involves running npm install followed by npm run dev, then opening the site in a browser at localhost port 3000. The project requires Node.js version 22 or higher, which is declared in the configuration so local setups match what runs in CI. Docker support is mentioned in the README as something planned for the future, not something available yet. The codebase is organized so that route files stay in src/app, shared interface pieces live in src/components, site wide settings sit in src/config, typed content lives in src/content, and page level feature composition happens in src/features. According to the roadmap notes, planned work includes a dashboard for tracking AI agent wallets, monitoring of payments, balances, and settlements, plus onboarding tools and an API marketplace for developers integrating with the protocol. This is a private licensed project, meaning the code is not openly licensed for reuse, and it is described as still under active development.