How naseem2917/promptwise works
PromptWise is a student-facing AI literacy workbench. Students can learn prompt principles, browse examples, take a quiz, or improve a prompt through validation, clarification questions, AI analysis and synthesis, then review scores and export the result to an external chatbot. Signed-in users can sync prompts and practice data; session drafts preserve in-progress work. The excerpts show the improvement/API and Firebase paths directly, while several other capabilities are documented in the README but their detailed implementations were not sampled.
Main entry points: App.tsx Route Shell · Improve.tsx Improve Workflow · db.ts Firestore Access · Quiz.tsx Practice Quiz
Components 26
Student Experience
- Route Shell
src/App.tsx - Home
src/pages/Home.tsx - Student Feedback
src/pages/Feedback.tsx
Prompt Improvement
- Improve Workflow
src/pages/Improve.tsx - Prompt Input
src/components/improve/PromptInput.tsx - Follow-up Questions
src/components/improve/QuestionCard.tsx - Diagnostic Score
src/components/improve/ScoreDisplay.tsx - Prompt Comparison
src/components/improve/BeforeAfter.tsx - Change Rationale
src/components/improve/ExplanationPanel.tsx - Chatbot Export
src/components/ui/ChatbotToolbar.tsx
Learning and Practice
- Learning Guides
src/pages/Learn.tsx - Prompt Examples
src/pages/Examples.tsx - Practice Quiz
src/pages/Quiz.tsx
Accounts and Persistence
- Student Dashboard
src/pages/Dashboard.tsx - Prompt History
src/pages/History.tsx - Feedback Admin
src/pages/Admin.tsx - Auth State
src/contexts/AuthContext.tsx - Google Sign-in
src/lib/auth.ts - Firebase Client
src/lib/firebase.ts - Firestore Access
src/lib/db.ts - Session History
src/lib/sessionHistory.ts
AI Service
- AI API Client
src/lib/api.ts - Cloudflare Worker
worker/index.ts
Other components
- Student
- AI Models
- External Chatbots
Connections 37
- Student → Route Shell: uses
README.md - Route Shell → Home: routes to
src/App.tsx - Route Shell → Improve Workflow: routes to
src/App.tsx - Route Shell → Learning Guides: routes to
src/App.tsx - Route Shell → Prompt Examples: routes to
src/App.tsx - Route Shell → Practice Quiz: routes to
src/App.tsx - Route Shell → Student Feedback: routes to
src/App.tsx - Route Shell → Student Dashboard: routes to
src/App.tsx - Route Shell → Prompt History: routes to
src/App.tsx - Route Shell → Feedback Admin: routes to
src/App.tsx - Improve Workflow → Prompt Input: renders
src/pages/Improve.tsx - Improve Workflow → Follow-up Questions: renders
src/pages/Improve.tsx - Improve Workflow → Diagnostic Score: renders
src/pages/Improve.tsx - Improve Workflow → Prompt Comparison: renders
src/pages/Improve.tsx - Improve Workflow → Change Rationale: renders
src/pages/Improve.tsx - Improve Workflow → AI API Client: requests analysis and synthesis
src/pages/Improve.tsx - Improve Workflow → Firestore Access: saves prompt
src/pages/Improve.tsx - Improve Workflow → Session History: preserves drafts
src/pages/Improve.tsx - Prompt Comparison → Chatbot Export: offers export
src/components/improve/BeforeAfter.tsx - Chatbot Export → External Chatbots: opens chatbot
README.md - AI API Client → Cloudflare Worker: sends API requests
- Cloudflare Worker → AI Models: uses model failover
README.md - Practice Quiz → AI API Client: requests quiz
src/pages/Quiz.tsx - Practice Quiz → Firestore Access: saves quiz result
src/pages/Quiz.tsx - Student Feedback → Firestore Access: submits feedback
src/pages/Feedback.tsx - Feedback Admin → Firestore Access: loads feedback
src/pages/Admin.tsx - Student Dashboard → Firestore Access: loads practice data
src/pages/Dashboard.tsx - Prompt History → Firestore Access: loads prompt records
src/pages/History.tsx - Auth State → Firebase Client: observes auth
src/contexts/AuthContext.tsx - Auth State → Firestore Access: upserts user
src/contexts/AuthContext.tsx - Google Sign-in → Firebase Client: signs in
src/lib/auth.ts - Firestore Access → Firebase Client: reads and writes
src/lib/db.ts - Session History → Firestore Access: maps prompt records
src/lib/sessionHistory.ts - Student → Learning Guides: studies prompt craft
README.md - Student → Prompt Examples: explores templates
README.md - Student → Practice Quiz: practices skills
README.md - Student → Student Feedback: submits feedback
README.md