AI Prompts Library

I'm building a KidsBuild app game. Create a complete game structure with:
- A main game component in src/App.tsx
- Score tracking using useAppState from @kidsbuild/sdk
- Game states: menu, playing, game-over
- A simple game loop using requestAnimationFrame or setInterval
- Responsive UI with Tailwind CSS
- A restart button on game over

The game should be [DESCRIBE YOUR GAME HERE - e.g., "a snake game", "a memory matching game", "a typing speed test"].

Use these imports:
import { KidsBuild, useUser, useAppState, useWallet } from '@kidsbuild/sdk'

Make sure the game saves high scores per user.

I'm building a KidsBuild productivity tool. Create a complete app structure with:
- Main component in src/App.tsx
- User data persistence using useAppState from @kidsbuild/sdk
- A clean, minimal UI with Tailwind CSS
- Dark mode support (the platform is dark by default)
- Settings panel for user preferences
- Export/import functionality if relevant

The tool should be [DESCRIBE YOUR TOOL HERE - e.g., "a note-taking app", "a habit tracker", "a flashcard study app"].

Use these imports:
import { KidsBuild, useUser, useAppState, useWallet } from '@kidsbuild/sdk'

I need help with KidsBuild state management. Show me how to:

1. Use useAppState to save and load a single value:
   const [score, setScore] = useAppState('score', 0)

2. Use useAppState to save and load an object:
   const [settings, setSettings] = useAppState('settings', { sound: true, difficulty: 'normal' })

3. Use useAppState to save and load an array:
   const [items, setItems] = useAppState('items', [])

Include TypeScript types and show how to properly update nested state.

Import from: import { useAppState } from '@kidsbuild/sdk'

I need help with advanced KidsBuild state patterns. Show me:

1. How to implement undo/redo with useAppState
2. How to migrate state when my data schema changes
3. How to handle loading states and errors
4. How to sync state between multiple components
5. How to batch multiple state updates

Use TypeScript and include proper error handling.

Import from: import { useAppState, useAppStateAsync } from '@kidsbuild/sdk'

Create a KidsBuild game HUD (heads-up display) component with:
- Score display with animated number changes
- Lives/hearts display
- Level indicator
- Timer (if applicable)
- Pause button
- Mobile-responsive layout (works on phones)
- Tailwind CSS styling matching dark theme

The HUD should be fixed at the top of the screen and not interfere with gameplay.

Props should include: score, lives, level, time, isPaused, onPause

Make it a reusable component I can import into any game.

Create a KidsBuild leaderboard component that:
- Fetches top scores from the KidsBuild API
- Shows rank, player name, and score
- Highlights the current user's position
- Has loading and empty states
- Supports pagination or infinite scroll
- Mobile-responsive with Tailwind CSS

Use these imports:
import { useLeaderboard, useUser } from '@kidsbuild/sdk'

The component should refresh automatically when new scores are submitted.

I'm ready to publish my KidsBuild app. Help me create a pre-publish checklist:

1. Code Quality
   - No console.log statements left in
   - No hardcoded test data
   - Proper error handling
   - TypeScript errors resolved

2. App Metadata
   - app.json has title, description, category
   - Icon is 512x512 PNG
   - Screenshots are 1280x720 or 720x1280

3. User Experience
   - Works on mobile (320px width minimum)
   - Loading states for async operations
   - Graceful error messages
   - Accessible (keyboard navigation, screen readers)

4. Testing
   - Tested with fresh user (no saved state)
   - Tested with saved state from previous session
   - Tested offline behavior

Walk me through each item and help me fix any issues.

Help me create the app.json metadata file for my KidsBuild app.

My app is: [DESCRIBE YOUR APP]

Generate a complete app.json with:
- name (lowercase, no spaces, like "my-awesome-game")
- title (display name with proper capitalization)
- description (2-3 sentences for marketplace listing)
- category (one of: game, tool, creative, social, education)
- tags (array of relevant keywords)
- ageRating ("everyone", "teen")
- pricing: { type: "free" } or { type: "paid", buildBucks: number }
- icon: "./assets/icon.png"
- screenshots: ["./assets/screenshot-1.png", ...]

Also suggest what my icon and screenshots should show.

Help me design a KidsBuild database schema for my app.

My app needs to store: [DESCRIBE YOUR DATA NEEDS]

Create a schema.json file with:
- Table definitions using the declarative format
- Proper column types (text, integer, boolean, json, timestamp)
- Indexes for frequently queried columns
- The appId column (required, auto-added by platform)

Example format:
{
  "tables": {
    "high_scores": {
      "columns": {
        "score": { "type": "integer", "nullable": false },
        "level": { "type": "integer", "default": 1 },
        "achieved_at": { "type": "timestamp", "default": "now()" }
      },
      "indexes": ["score"]
    }
  }
}

Remember: KidsBuild uses protected tables, so I can't write raw SQL. I define the schema declaratively and the platform handles migrations.

I need to update my KidsBuild app's database schema. My current schema has:
[DESCRIBE CURRENT SCHEMA]

I need to add/change:
[DESCRIBE CHANGES]

Help me:
1. Create a new schema version in schema.json
2. Understand what migrations the platform will auto-generate
3. Handle any data that needs to be transformed
4. Test the migration locally before publishing

Remember: I can't write raw SQL on KidsBuild. Schema changes are declarative and the platform handles the actual migration safely.

I'm having issues with state in my KidsBuild app. Help me debug:

Symptoms: [DESCRIBE THE PROBLEM - e.g., "state resets on refresh", "state not updating UI", "wrong initial value"]

My current code:
[PASTE YOUR useAppState CODE]

Check for these common issues:
1. Is the key string unique and consistent?
2. Is the initial value the correct type?
3. Am I mutating state directly instead of using setter?
4. Is the component wrapped in <KidsBuild>?
5. Am I awaiting async operations properly?

Add console.log statements to trace the issue and suggest fixes.

I'm getting API errors in my KidsBuild app. Help me debug:

Error message: [PASTE ERROR]
API endpoint: [WHICH ENDPOINT]
Request data: [WHAT YOU'RE SENDING]

Check for:
1. Authentication - is the user logged in?
2. Permissions - does the app have access to this API?
3. Rate limiting - are you making too many requests?
4. Data validation - is the request body correct?
5. Network issues - is the request reaching the server?

Show me how to add proper error handling and retry logic.