@ct0dev/mini-app-sdk v1.0.4

🧩 @ct0/mini-app-sdk

A lightweight React Native SDK to simplify building AI-generated mini-apps inside ct0.dev.

Includes:

• ✅ App & user context (MiniAppProvider)
• ✅ Flexible CRUD (useCrud) for any collection
• ✅ Shared vs private access support
• ✅ Auto caching via AsyncStorage
• ✅ Extensible structure for future hooks (assets, auth, etc.)

✨ Installation

npm install @ct0/mini-app-sdk
# or
yarn add @ct0/mini-app-sdk

Peer dependencies:

- react
- react-dom
- @react-native-async-storage/async-storage

⚙️ Usage

1. Wrap your mini-app with MiniAppProvider

import { MiniAppProvider } from '@ct0/mini-app-sdk';

export default function App() {
  return (
    <MiniAppProvider
      appId="your-app-id"
      userId="ajay"
      apiBaseUrl="https://api.ct0.in"
      theme="dark"
      language="en"
      onClose={() => console.log('App closed')}
      onError={(err) => console.error(err)}
    >
      <YourMiniApp />
    </MiniAppProvider>
  );
}

2. Use Context Anywhere

import { useMiniAppContext } from '@ct0/mini-app-sdk';

const {
  appId,
  userId,
  apiBaseUrl,
  theme,
  language,
  onClose,
  onError
} = useMiniAppContext();

3. Use CRUD for Collections

import { useCrud } from '@ct0/mini-app-sdk';

const { items, create, update, remove, refresh, loading } = useCrud('todos');

Shared access (e.g. group data)

const { items } = useCrud('expenses', { access: 'shared' });

💾 Caching & Offline Support

• All useCrud() data is cached in AsyncStorage
• Auto loaded on mount, then updated in background
• Automatically updated on create, update, remove

🧱 API Summary

🔮 Planned Additions

✅ 𝙲𝙾𝚁𝙴 𝙰𝙿𝙸 𝙰𝙱𝚂𝚃𝚁𝙰𝙲𝚃𝙸𝙾𝙽𝚂

🎨 𝚄𝚂𝙴𝚁 𝙴𝚇𝙿𝙴𝚁𝙸𝙴𝙽𝙲𝙴

🧰 𝙲𝙾𝙼𝙿𝙾𝙽𝙴𝙽𝚃 + 𝚂𝚃𝙰𝚃𝙴 𝚄𝚃𝙸𝙻𝚂

🔁 𝚁𝙴𝙰𝙻𝚃𝙸𝙼𝙴 + 𝙲𝙾𝙻𝙻𝙰𝙱

🧩 𝚂𝙿𝙴𝙲𝙸𝙰𝙻 𝙼𝙾𝙳𝙴𝙻𝚂 / 𝙲𝙰𝚂𝙴𝚂

📋 𝙿𝙻𝙰𝚃𝙵𝙾𝚁𝙼 𝚂𝚄𝙿𝙿𝙾𝚁𝚃

🧪 EXAMPLE ROLLING PLAN

• ✅ useCrud(), useAssets(), useAuth()
• ✅ useMeta(), useStorage()
• 🔜 useNotifications(), useLocation(), usePrompt()
• 🔜 useRealtime(), useShare(), useCamera()
• 🔜 Advanced: useExperiments(), useScheduler(), usePresence()

🧪 Dev Commands

yarn build       # Compile SDK to dist/
yarn dev         # Watch mode (Rollup)
yarn lint        # ESLint
yarn format      # Prettier

📦 This SDK powers…

✅ Todo apps
✅ Expense splitters
✅ Journals, trackers, diaries
✅ Group shared utilities
…and 100s of AI-generated ct0.dev apps!

Made for dynamic creativity at ct0.dev