create-sbc-app 0.1.1

package/templates/README.md

@@ -0,0 +1,48 @@
+# create-sbc-app
+
+This directory contains ready-to-use templates for quickly starting new projects with the SBC App Kit. Each template is a minimal, fully functional app that demonstrates best practices for integrating @stablecoin.xyz/core and @stablecoin.xyz/react.
+
+## Available Templates
+
+- **react/** – Minimal React app with SBC integration (Vite)
+
+## How to Use a Template
+
+1. **Copy the template directory** you want to use:
+
+   ```bash
+   cp -r create-sbc-app/react my-new-sbc-app
+   # or for Next.js:
+   cp -r create-sbc-app/nextjs my-new-sbc-next-app
+   ```
+
+2. **Install dependencies:**
+
+   ```bash
+   cd my-new-sbc-app
+   pnpm install
+   # or
+   npm install
+   ```
+
+3. **Run the app:**
+
+   ```bash
+   pnpm dev
+   # or
+   npm run dev
+   ```
+
+4. **Customize as needed:**
+   - Update the API key and config in `src/App.tsx` or `app/page.tsx`.
+   - Follow the template’s README for more details.
+
+## Keeping Templates Up to Date
+
+- All templates use the latest published versions of SBC packages.
+- Code and config are kept in sync with the main repo’s best practices.
+- If you find an issue, please open a PR or issue in the main repo.
+
+---
+
+Each template has its own README with specific instructions and details.

package/templates/react/.env

@@ -0,0 +1,2 @@
+# SBC App Kit Configuration
+VITE_SBC_API_KEY={{apiKey}}

package/templates/react/.eslintrc.cjs

@@ -0,0 +1,18 @@
+module.exports = {
+  root: true,
+  env: { browser: true, es2020: true },
+  extends: [
+    'eslint:recommended',
+    '@typescript-eslint/recommended',
+    'plugin:react-hooks/recommended',
+  ],
+  ignorePatterns: ['dist', '.eslintrc.cjs'],
+  parser: '@typescript-eslint/parser',
+  plugins: ['react-refresh'],
+  rules: {
+    'react-refresh/only-export-components': [
+      'warn',
+      { allowConstantExport: true },
+    ],
+  },
+} 

package/templates/react/README.md

@@ -0,0 +1,146 @@
+# {{projectName}}
+
+A gasless smart account application powered by [SBC (Stable Coin Inc)](https://stablecoin.xyz).
+
+## 🚀 Quick Start
+
+### 1. Install Dependencies
+```bash
+npm install
+```
+
+### 2. Configure Environment Variables
+Copy the example environment file and add your SBC API key:
+
+```bash
+cp .env.example .env # Optional: for local overrides
+```
+
+Edit `.env` and add your SBC API key:
+```bash
+VITE_SBC_API_KEY=your_api_key_here
+VITE_SBC_CHAIN={{chain}}
+VITE_SBC_DEBUG=true
+```
+
+> **Get your API key:** Visit the [SBC Dashboard](https://dashboard.stablecoin.xyz) to create an account and get your API key.
+
+### 3. Start the Development Server
+```bash
+npm run dev
+```
+
+Your app will be available at `http://localhost:3000` 🎉
+
+## 🔥 What You'll See
+
+This example app demonstrates:
+
+- **🔗 Wallet Connection**: Connect any Ethereum wallet
+- **🏦 Smart Account Creation**: Automatically creates a gasless smart account
+- **⛽ Gasless Transactions**: Send transactions without paying gas fees
+- **💰 Balance Checking**: Check your account balance
+- **🔧 Ready-to-Use Setup**: Environment variables and error handling included
+
+## 🛠 How It Works
+
+### Environment Variables (Vite)
+The app uses Vite's environment variables with the `VITE_` prefix:
+
+```typescript
+const config = {
+  apiKey: import.meta.env.VITE_SBC_API_KEY,
+  chain: {{chain}},
+  debug: import.meta.env.VITE_SBC_DEBUG === 'true'
+};
+```
+
+### SBC Integration
+```typescript
+import { SbcProvider, useSbcApp, WalletConnect } from '@stablecoin.xyz/react';
+
+// 1. Wrap your app with SbcProvider
+<SbcProvider config={config}>
+  <YourApp />
+</SbcProvider>
+
+// 2. Use the SBC hooks
+const { sbcAppKit, account, isInitialized } = useSbcApp();
+
+// 3. Send gasless transactions
+const tx = await sbcAppKit.sendTransaction({
+  to: recipientAddress,
+  value: parseEther('0.001'),
+  data: '0x'
+});
+```
+
+## 📚 Available Scripts
+
+- `npm run dev` - Start development server
+- `npm run build` - Build for production
+- `npm run preview` - Preview production build
+- `npm run lint` - Run ESLint
+
+## 🔧 Development
+
+### Project Structure
+```
+src/
+├── App.tsx          # Main app with SBC integration
+├── main.tsx         # Vite entry point
+├── App.css          # Styles
+└── index.css        # Global styles
+```
+
+### Adding Your Own Features
+
+1. **Custom Transactions**: Modify the `sendGaslessTransaction` function in `App.tsx`
+2. **Smart Contract Interactions**: Use `sbcAppKit.sendTransaction()` with contract calls
+3. **Additional UI**: Add new components and import them in `App.tsx`
+
+## 🌐 Chain Configuration
+
+This app is configured for **{{chain}}**. To use a different chain:
+
+1. Update `.env`:
+   ```bash
+   VITE_SBC_CHAIN=your_chain_here
+   ```
+
+2. Update the import in `App.tsx`:
+   ```typescript
+   import { yourChain } from 'viem/chains';
+   ```
+
+## 📖 Learn More
+
+- [SBC Documentation](https://docs.stablecoin.xyz)
+- [SBC React SDK](https://www.npmjs.com/package/@stablecoin.xyz/react)
+- [Viem Documentation](https://viem.sh)
+- [React Documentation](https://react.dev)
+
+## 🆘 Troubleshooting
+
+### "Configuration Required" Error
+- Make sure you've set `VITE_SBC_API_KEY` in your `.env` file
+- Restart the dev server after changing environment variables
+
+### Transaction Failures
+- Check that you're on the correct network ({{chain}})
+- Ensure your wallet has a small amount of ETH for account deployment
+- Check the browser console for detailed error messages
+
+### Build Issues
+- Make sure all dependencies are installed: `npm install`
+- Try clearing the cache: `rm -rf node_modules package-lock.json && npm install`
+
+## 🔐 Security
+
+- Never commit your `.env` file with real API keys
+- Use `.env.local` for local development overrides
+- The `.env` file in this template is for demonstration only
+
+---
+
+**Happy building with SBC! 🚀** 

package/templates/react/eslint.config.js

@@ -0,0 +1,32 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from '@typescript-eslint/eslint-plugin'
+import tsparser from '@typescript-eslint/parser'
+
+export default [
+  { ignores: ['dist'] },
+  {
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parser: tsparser,
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...tseslint.configs.recommended.rules,
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+] 

package/templates/react/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/png" href="/sbc-logo.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#000000" />
+    <meta
+      name="description"
+      content="{{projectName}} - SBC-powered application"
+    />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html> 

package/templates/react/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@stablecoin.xyz/core": "latest",
+    "@stablecoin.xyz/react": "latest",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "viem": "^2.31.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0"
+  }
+}