Стартові шаблони (Starter Templates)
Найшвидший спосіб спробувати екосистему TUWA — це розгорнути готовий шаблон із репозиторію Cosmos Playground : це повнофункціональний додаток із підключенням гаманців (Nova Connect на базі Satellite Connect), відстеженням транзакцій (Pulsar) та модальними вікнами й тостами (Nova Transactions). Більшість шаблонів використовують пакет @tuwaio/sdk; шаблон nextjs-tuwa-not-sdk демонструє встановлення окремих модулів безпосередньо, як у нашому посібнику з відстеження транзакцій у React.
🚀 Доступні шаблони
| Шаблон | Функціонал та демонстрація | Стек технологій | Рівень |
|---|---|---|---|
nextjs-tuwa | EVM та Solana: підключення гаманців і трекінг транзакцій (стандартні та ERC-4337) | Next.js 16, @tuwaio/sdk, @wagmi/core, @solana/kit | Beginner |
nextjs-evm | Тільки EVM: авторизація гаманцем через SIWX (CAIP-122) та серверні сесії | Next.js 16, @tuwaio/sdk, @wagmi/core | Beginner |
nextjs-solana | Тільки Solana: вхід через SIWX (CAIP-122), серверні сесії та клієнт програми з Codama | Next.js 16, @tuwaio/sdk, @solana/kit | Beginner |
vite-tuwa | SPA-аналог шаблону nextjs-tuwa на чистому клієнтському стеку Vite | Vite 8, @tuwaio/sdk, @wagmi/core, @solana/kit | Beginner |
nextjs-tuwa-not-sdk | Аналог nextjs-tuwa, але на окремих атомарних пакетах замість монолітного SDK | Next.js 16, @wagmi/core, @solana/kit, @tuwaio/pulsar-* | Intermediate |
custom-style | Кастомізація UI: стилізація Nova Connect та Transactions через змінні --tuwa-* (демо ) | Vite 8, @tuwaio/sdk | Intermediate |
nextjs-tuwa-quasar | Повний стек: SIWX, синхронізація транзакцій із Quasar Cloud, історія гаманця та вебхуки (демо ) | Next.js 16, @tuwaio/sdk, @tuwaio/quasar-sdk | Advanced |
Вихідний код кожного шаблону знаходиться у папці cosmos-playground/examples . У файлі README для кожного прикладу перелічено необхідні змінні оточення та доступні скрипти.
WagmiProvider і не тягне бібліотеку React Query: модулі Satellite Connect та Pulsar викликають напряму чисті функції @wagmi/core. Шаблони із сесіями SIWX зберігають сесію в підписаних HttpOnly-куках і можуть працювати навіть без окремої бази даних.🛠️ Створення проекту
1. Запустіть інтерактивний CLI
npx @tuwaio/create-cosmos-playgroundУтиліта запропонує обрати шаблон і назву проекту, клонує код із GitHub та встановить залежності за допомогою pnpm (або bun/yarn/npm, якщо pnpm не встановлено).
2. Налаштування змінних оточення та старт
Кожен шаблон містить файл .env.example. Скопіюйте його у .env, вкажіть за потреби власні ключі RPC або Quasar та запустіть сервер розробки:
cp .env.example .envpnpm devЩоб отримувати вебхуки Quasar локально у шаблоні nextjs-tuwa-quasar, виконайте команду pnpm webhooks у сусідньому терміналі поруч із pnpm dev.
3. Спільна розробка зі штучним інтелектом (AI Agents)
Кожен шаблон постачається із файлом AGENTS.md, який регламентує правила для AI-асистентів і посилається на офіційний канонічний документ TUWA_AGENTS.md .