🐝 Teacher Hive Builder Companion

Welcome to Builder Academy.

Learn how to build classroom-ready Teacher Hive apps, choose the right Superpowers, set up AI safely, generate prompts, and publish with confidence.

Superpowers Academy

Each card explains what the Superpower does, when to use it, and what kinds of apps it unlocks.

🤖

AI Superpower

What it does: Generates text or images for the person using the app.

  • Teacher example: Writing feedback coach
  • Teacher example: Reading-level analyzer
  • Teacher example: Story starter generator
🔄

Connected Superpower

What it does: Saves and syncs app data live between the teacher and guests.

  • Teacher example: Exit ticket dashboard
  • Teacher example: Class poll
  • Teacher example: Leaderboard review game
📧

Email Superpower

What it does: Sends formatted messages to the app owner’s inbox.

  • Teacher example: Quiz result digest
  • Teacher example: Suggestion box
  • Teacher example: Photo-based reflection
🔗

Short Link Superpower

What it does: Converts long URLs into short link.apphive.us links.

  • Teacher example: QR code station links
  • Teacher example: Shareable game setup
  • Teacher example: Long data-packed links
🗂️

File Locker Superpower

What it does: Stores image, audio, PDF, and other app files.

  • Teacher example: Audio directions
  • Teacher example: Game images
  • Teacher example: PDF rubrics
📊

Stats / Usage

What it does: Helps the app owner understand app visits and usage.

  • Teacher example: See if students opened it
  • Teacher example: Compare usage over time
  • Teacher example: Track resource popularity

Superpower How-To Guide

Choose any Superpower above to see a teacher-friendly how-to guide with classroom examples.

AI Setup & API Key Safety

Help teachers understand AI keys, choose the right Teacher Hive AI mode, and find where to create their own provider key.

Start Here: AI Key Basics

Lesson 1An API is how an app talks to an outside service.
Lesson 2An API key is like a password for a paid AI account.
Lesson 3Teachers do not share keys with one another.
Lesson 4Student apps should use the teacher’s AI key in Teacher Hive.
Lesson 5Teacher-facing apps can let each educator bring their own key.
Lesson 6Never paste an API key into public app code.

Choose the right AI mode

🏫 Student-facing app Choose Use My AI Key. Students never enter a key. You provide the AI access through Teacher Hive and set a daily spending cap.
👩‍🏫 Teacher-facing app Choose Bring Your Own AI Key. Each teacher uses their own AI account. Your key is not shared with anyone.
Recommendation: Use My AI Key for student-facing classroom apps. Students should never need to create or paste API keys.

Where do I get an API key?

🟣 Claude / Anthropic

Best for writing, feedback, tutoring, rubrics, text analysis, and lesson support.

  • Great for text generation
  • Strong for thoughtful feedback
  • Not for image generation
Get Anthropic API Key

🟢 Google Gemini

Best for multimodal tasks, image-friendly workflows, and educators already using Google tools.

  • Google AI Studio key
  • Good for text and multimodal work
  • Image generation may require paid Gemini access
Get Gemini API Key

⚫ OpenAI / ChatGPT

Best for general AI, coding help, image generation, app ideas, and broad classroom tools.

  • OpenAI API is separate from ChatGPT login
  • Strong general-purpose option
  • Good choice for image generation apps
Get OpenAI API Key

Before You Create or Use a Key

✅ API keys are different from your ChatGPT, Claude, or Gemini login.
✅ Never email an API key or share it in a document.
✅ Never paste an API key into public HTML or JavaScript.
✅ Store provider keys only in Teacher Hive settings or the app’s secure key flow.
✅ Delete and recreate a key if you think it was exposed.
✅ Set daily spending caps when using your own key for student-facing apps.

Unsafe vs safe AI calls

❌ Unsafe public-code pattern

This puts the API key directly in public JavaScript. Do not do this.

const apiKey = "PASTE_REAL_KEY_HERE";

fetch("https://api.provider.com/ai", {
  method: "POST",
  headers: { "Authorization": "Bearer " + apiKey },
  body: JSON.stringify({ prompt })
});
✅ Safe Teacher Hive pattern

The app calls Teacher Hive’s AI Superpower. The key is handled through Teacher Hive, not public app code.

async function callTeacherHiveAI(prompt) {
  // Paste Teacher Hive's official AI Instructions here.
  // Do not paste your real AI key into this code.
  // Teacher Hive handles the provider call safely.
}
Your AI setup plan will appear here.

Copy-ready safe builder instruction

Build this app for Teacher Hive as a single HTML file. Do not expose API keys. Do not call Anthropic, OpenAI, or Gemini directly from public frontend JavaScript. Use Teacher Hive's official AI Superpower instructions for all AI calls. For student-facing apps, use "Use My AI Key." For teacher-facing apps, use "Bring Your Own AI Key," meaning each teacher uses their own AI provider account. Include comments showing where Teacher Hive-specific code belongs.

Superpower Decision Tree

Answer a few questions and get a practical recommendation.

StudentsShared in class or through a link.
TeachersShared with colleagues or at PD.
Families / CommunityPublic-facing or informational.
Generate text or imagesFeedback, stories, questions, images.
Save or sync responsesSubmissions, scores, leaderboards.
Send me resultsDigest, report, notification.
Create share linksLong URLs that need shortening.
Use media or filesImages, PDFs, audio, resources.
Just a simple appNo advanced Superpower needed.
Your recommendation will appear here.

App Idea Generator

Describe a classroom need and get a complete Teacher Hive build plan.

Your Teacher Hive build plan will appear here.

AI Builder Prompt Generator

Create a copy-ready prompt for Claude, ChatGPT, or Gemini to build your Teacher Hive app.

Your builder prompt will appear here.

Tip: In Teacher Hive, copy the official AI Instructions for each Superpower you enable and paste them above this generated prompt.

Template Gallery

Click a template to load a suggested build plan and Superpower stack.

📚 Reading CoachAI feedback, reading-level support, teacher summaries.
🎟️ Exit TicketAnonymous responses, teacher email digest, quick checks.
🎲 Review GameScores, leaderboard, game questions, live sync.
✍️ Story StarterAI-generated prompts and creative writing support.
🖼️ Gallery WalkShared submissions, teacher controls, file assets.
✅ Rubric HelperAI rubric feedback for teachers or students.
🕵️ Scavenger HuntShort links, QR clues, files, live progress.
👩‍🏫 PD CompanionTeacher-facing AI assistant with their own AI account.
Template details will appear here.

Privacy Checker

Paste your app idea, prompt, or instructions and check for student privacy risks.

This tool checks for common red flags like names, emails, student IDs, location collection, hidden tracking, or sensitive information.

Teacher Hive Readiness Score

Use this checklist before publishing or sharing an app with students.

0%
Check items to calculate your readiness score.

Superpower Mini Demos

These demos simulate how the Superpowers work. Replace placeholders with Teacher Hive’s official instructions when building.

🤖

AI Demo

Simulates generating feedback with AI.

Waiting...
🔗

Short Link Demo

Simulates turning a giant app URL into a short link.

Waiting...
📧

Email Demo

Simulates sending an app summary to the teacher owner.

Waiting...