https://github.com/aboutcircles/circles-gnosisApp-starter-kit

Circles × Gnosis App Starter Kit
https://github.com/aboutcircles/circles-gnosisApp-starter-kit

Last synced: about 1 month ago
JSON representation

Circles × Gnosis App Starter Kit

• Host: GitHub
• URL: https://github.com/aboutcircles/circles-gnosisApp-starter-kit
• Owner: aboutcircles
• Created: 2026-01-30T14:18:20.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2026-02-28T09:44:33.000Z (5 months ago)
• Last Synced: 2026-03-01T03:59:17.750Z (5 months ago)
• Language: TypeScript
• Homepage:
• Size: 4.01 MB
• Stars: 0
• Watchers: 0
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-circles - circles-gnosisApp-starter-kit - Official TypeScript starter for Gnosis × Circles apps. (Starter Kits & Tutorials / Developer Demos)

README

          
# Circles × Gnosis App Starter Kit

A mobile-first Next.js boilerplate for building Circles payment flows that open directly in the Gnosis app and verify payments via the Circles RPC.

![Demo1](Demo1.png)

![Demo2](Demo2.png)

## What’s included

- Gnosis deep link generator for CRC transfers

- Circles RPC polling for `CrcV2_TransferData`

- Mobile-first layout 

## Quickstart

```bash

npm install

npm run dev

```

## How it works

- Build a payment payload (recipient, amount, description)

- Send the description directly in the `data` field (no hash)

- Generate the Gnosis app transfer URL

- Poll Circles RPC for matching `data` values filtered by recipient address

## Customize

- `src/lib/circles.ts` for RPC + payment rules

- `src/hooks/use-payment-watcher.ts` for polling cadence

- `src/components/ui/*` for shadcn-style primitives

- `src/app/page.tsx` for the main flow