create-dubhe 1.2.0-pre.98 → 2.0.0

package/templates/nextjs/sui-card-duel/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - packages/*

package/templates/nextjs/sui-farm/.gitignore_

@@ -0,0 +1,51 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# dubhe 
+contracts/dubhe-framework/.history
+contracts/dubhe-framework/Move.lock
+**/build/
+src/chain/key.ts
+indexer.db
+node_logs
+mprocs.log
+.data/

package/templates/nextjs/sui-farm/README.md

@@ -0,0 +1,15 @@
+## How to use
+
+```bash
+1. install sui <https://docs.sui.io/build/install>
+2. cd dubhe-nextjs-template folder
+3. pnpm install
+4. open new window && pnpm start:localnet
+5. open new window && pnpm dev
+```
+
+Environment: node.js (v18.20.0+) ([download](https://nodejs.org/en/download/))
+
+> Please use `node -v` check your node version
+
+Deploy it to the cloud with [Vercel](https://vercel.com/new?utm_source=github&utm_medium=readme&utm_campaign=next-example) ([Documentation](https://nextjs.org/docs/deployment)).

package/templates/nextjs/sui-farm/UPGRADE_NOTES.md

@@ -0,0 +1,97 @@
+# Dubhe NextJS Template Upgrade Notes
+
+## Overview
+
+This document outlines the major improvements made to the NextJS template based on the latest patterns from the 101 template.
+
+## Major Updates
+
+### 1. New Dependencies Added
+
+- `@0xobelisk/graphql-client`: Advanced GraphQL client for data querying and subscriptions
+- `@0xobelisk/ecs`: Entity Component System world client for game-oriented data management
+- `viem`: Updated blockchain library for enhanced transaction handling
+
+### 2. New Architecture Components
+
+#### useContract Hook (`src/app/dubhe/useContract.ts`)
+
+- Centralized contract management with optimized caching
+- Integrated GraphQL client initialization
+- ECS World setup with batch optimization
+- Automatic reconnection on errors
+- Configurable query timeouts and debouncing
+
+### 3. Enhanced Query Logic
+
+#### Dual Client System
+
+- **ECS Client**: Optimized for game development with component-based architecture
+- **GraphQL Client**: Universal data access with flexible query capabilities
+
+#### Real-time Features
+
+- Live subscriptions to data changes
+- Automatic UI updates when transactions complete
+- Error handling and reconnection logic
+
+### 4. Improved User Interface
+
+#### Tab-based Navigation
+
+- Switch between ECS and GraphQL clients
+- Visual indicators for recommended approaches
+- Responsive design with modern styling
+
+#### Advanced Data Querying
+
+- Component data exploration with entity browsing
+- Resource data querying with filtering
+- Table data inspection with field information
+- Real-time data count display
+
+#### Enhanced UX Features
+
+- Loading states for all operations
+- Comprehensive error handling
+- Transaction success notifications with explorer links
+- Detailed logging for debugging
+
+### 5. Performance Optimizations
+
+- Memoized client instances to prevent unnecessary re-renders
+- Batch query optimization for ECS operations
+- Debounced subscriptions to prevent spam
+- Cached component and resource data
+
+## Usage Instructions
+
+1. **Install Dependencies**: The new dependencies are already added to package.json
+2. **Environment Setup**: Configure GraphQL endpoints in your environment variables:
+   ```
+   NEXT_PUBLIC_GRAPHQL_ENDPOINT=http://localhost:4000/graphql
+   NEXT_PUBLIC_GRAPHQL_WS_ENDPOINT=ws://localhost:4000/graphql
+   ```
+3. **Development**: The application now provides two separate client interfaces - use the ECS client for game development scenarios and GraphQL client for general data access.
+
+## Migration Notes
+
+- The old query logic has been completely replaced with the new dual-client system
+- All existing functionality is preserved but with improved performance and capabilities
+- The UI is now more comprehensive and provides better developer experience
+- Real-time subscriptions are now available out of the box
+
+## Benefits
+
+1. **Better Performance**: Optimized queries and caching reduce unnecessary network calls
+2. **Enhanced Developer Experience**: Rich UI provides better insight into data structures
+3. **Future-Proof**: Modern architecture supports both current and upcoming features
+4. **Flexibility**: Choice between ECS and GraphQL clients based on use case
+5. **Reliability**: Improved error handling and automatic reconnection features
+
+## Next Steps
+
+- Test the new functionality in your development environment
+- Explore the component and resource querying features
+- Utilize the real-time subscription capabilities for your application
+- Consider migrating existing query logic to use the new patterns

package/templates/nextjs/sui-farm/docker-compose.yml

@@ -0,0 +1,34 @@
+services:
+  postgres:
+    image: 'postgres:13'
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: postgres
+    ports:
+      - '127.0.0.1:5432:5432'
+    volumes:
+      - ./.data/postgres:/var/lib/postgresql/data
+    restart: always
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U postgres']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  graphql-server:
+    build: ./packages/contracts
+    ports:
+      - '4000:4000'
+    environment:
+      - DATABASE_URL=postgresql://postgres:postgres@postgres:5432/postgres
+    depends_on:
+      postgres:
+        condition: service_healthy
+    restart: always
+    command: npx @0xobelisk/graphql-server start
+    healthcheck:
+      test: ['CMD', 'wget', '-qO-', 'http://127.0.0.1:4000/health']
+      interval: 10s
+      timeout: 5s
+      retries: 5

package/templates/nextjs/sui-farm/mprocs.yaml

@@ -0,0 +1,17 @@
+scrollback: 10000
+procs:
+  client:
+    cwd: packages/client
+    shell: pnpm dubhe wait --local-indexer && pnpm dev
+  graphql:
+    cwd: .
+    shell: docker-compose down && rm -rf .data/postgres && docker-compose up --remove-orphans
+  contracts:
+    cwd: packages/contracts
+    shell: pnpm dubhe wait --localnet && pnpm setup:localnet
+  node:
+    cwd: packages/contracts
+    shell: pnpm dubhe node --force
+  shell:
+    cwd: packages/contracts
+    shell: pnpm dubhe wait --local-indexer && pnpm dubhe shell

package/templates/nextjs/sui-farm/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "dubhe-nextjs-farm",
+  "version": "1.0.0",
+  "description": "Harvest - Full-chain casual farming game built with Dubhe",
+  "type": "module",
+  "scripts": {
+    "dev": "mprocs",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@0xobelisk/sui-cli": "{{dubhe-version}}",
+    "@0xobelisk/sui-client": "{{dubhe-version}}",
+    "@0xobelisk/sui-common": "{{dubhe-version}}",
+    "dotenv": "^16.4.5",
+    "jotai": "^1.7.2",
+    "next": "^15.2.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sonner": "^1.5.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@types/node": "^18",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "15.2.3",
+    "eslint-config-prettier": "^9.1.0",
+    "mprocs": "^0.7.1",
+    "postcss": "^8",
+    "prettier": "3.3.3",
+    "tailwindcss": "^3.4.1",
+    "typescript": "^5.7.2",
+    "wait-on": "^8.0.3"
+  },
+  "packageManager": "pnpm@9.12.3",
+  "engines": {
+    "node": ">=18.x",
+    "pnpm": ">=9.x"
+  }
+}

package/templates/nextjs/sui-farm/packages/client/.gitignore_

@@ -0,0 +1,48 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# dubhe 
+contracts/dubhe/.history
+contracts/dubhe/Move.lock
+**/build/
+src/chain/key.ts
+indexer.db

package/templates/nextjs/sui-farm/packages/client/.prettierignore

@@ -0,0 +1 @@
+pnpm-lock.yaml

package/templates/nextjs/sui-farm/packages/client/.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "semi": true,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "printWidth": 100,
+  "trailingComma": "none"
+}

package/templates/nextjs/sui-farm/packages/client/eslint.config.mjs

@@ -0,0 +1,22 @@
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { FlatCompat } from '@eslint/eslintrc';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends('next/core-web-vitals', 'next/typescript', 'prettier'),
+  {
+    files: ['**/*.{js,jsx,ts,tsx}'],
+    rules: {
+      // Add custom rules here
+    },
+  },
+];
+
+export default eslintConfig;

package/templates/nextjs/sui-farm/packages/client/next.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  images: {
+    unoptimized: true
+  }
+};
+
+export default nextConfig;

package/templates/nextjs/sui-farm/packages/client/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "client",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "account:gen": "pnpm dubhe generate-key --use-next-public",
+    "build": "next build",
+    "dev": "pnpm next",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@0xobelisk/ecs": "{{dubhe-version}}",
+    "@0xobelisk/graphql-client": "{{dubhe-version}}",
+    "@0xobelisk/react": "{{dubhe-version}}",
+    "@0xobelisk/sui-cli": "{{dubhe-version}}",
+    "@0xobelisk/sui-client": "{{dubhe-version}}",
+    "@0xobelisk/sui-common": "{{dubhe-version}}",
+    "@mysten/dapp-kit": "0.16.14",
+    "@tanstack/react-query": "^5.17.19",
+    "contracts": "workspace:*",
+    "dotenv": "^16.4.5",
+    "framer-motion": "^11.18.2",
+    "idb-keyval": "^6.2.2",
+    "jotai": "^1.7.2",
+    "next": "^15.2.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sonner": "^1.5.0",
+    "viem": "2.21.19"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@types/node": "^18",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "eslint": "^8.56.0",
+    "eslint-config-next": "15.2.3",
+    "eslint-config-prettier": "^9.1.0",
+    "postcss": "^8",
+    "prettier": "3.3.3",
+    "tailwindcss": "^3.4.1",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/nextjs/sui-farm/packages/client/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    tailwindcss: {},
+  },
+};
+
+export default config;