How inspir Works

​

Platform Architecture

​

Technology Stack

​

How It Works: End-to-End

​

1. User Workflow

// Backend accepts TXT and DOCX files
const allowedTypes = ['text/plain', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'];
const maxSize = 10 * 1024 * 1024; // 10MB limit

// 1. Build context from user input
const context = {
  topic: userTopic,
  content: extractedText || userNotes,
  sourceName: fileName || topic
};

// 2. Send to Claude API
const response = await anthropic.messages.create({
  model: "claude-3-5-sonnet-20241022",
  max_tokens: 4096,
  messages: [{
    role: "user",
    content: promptTemplate(context)
  }]
});

// 3. Parse structured JSON response
const quiz = JSON.parse(response.content[0].text);

-- Quizzes table
CREATE TABLE quizzes (
  id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
  user_id UUID REFERENCES auth.users(id),
  source_name TEXT NOT NULL,
  questions JSONB NOT NULL,
  created_at TIMESTAMP DEFAULT NOW(),
  share_token TEXT UNIQUE
);

-- Quiz attempts table
CREATE TABLE quiz_attempts (
  id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
  quiz_id UUID REFERENCES quizzes(id),
  user_id UUID REFERENCES auth.users(id),
  answers JSONB NOT NULL,
  score INTEGER NOT NULL,
  created_at TIMESTAMP DEFAULT NOW()
);

// Simple letter comparison
const isCorrect = userAnswer === correctAnswer;

// AI-powered evaluation via Claude
const evaluation = await anthropic.messages.create({
  model: "claude-3-5-sonnet-20241022",
  messages: [{
    role: "user",
    content: `Question: ${question}
Correct Answer: ${correctAnswer}
Student Answer: ${userAnswer}

Evaluate if the student answer demonstrates understanding.`
  }]
});

​

AI-Powered Features Deep Dive

​

Quiz Generator

{
  "sourceName": "American Revolution",
  "questions": [
    {
      "question": "What was the primary cause of the American Revolution?",
      "type": "multiple_choice",
      "options": [
        "Taxation without representation",
        "Religious persecution",
        "Land disputes with France",
        "Economic depression"
      ],
      "correct_answer": "A",
      "explanation": "The slogan 'no taxation without representation' became..."
    }
  ]
}

import mammoth from 'mammoth';

const result = await mammoth.extractRawText({
  path: uploadedFile.path
});
const extractedText = result.value;

import fs from 'fs';

const extractedText = fs.readFileSync(
  uploadedFile.path, 
  'utf-8'
);

// Quiz generation: 10 per hour per IP
const quizGenerationLimiter = rateLimit({
  windowMs: 60 * 60 * 1000, // 1 hour
  max: 10,
  message: 'Too many quiz generation requests'
});

// Quiz submission: 30 per hour per IP
const quizSubmissionLimiter = rateLimit({
  windowMs: 60 * 60 * 1000,
  max: 30,
  message: 'Too many quiz submissions'
});

​

Doubt Solver

{
  "question_text": "Solve x² + 5x + 6 = 0",
  "subject": "Mathematics",
  "solution_steps": [
    "Factor the quadratic equation: (x + 2)(x + 3) = 0",
    "Set each factor equal to zero: x + 2 = 0 or x + 3 = 0",
    "Solve for x: x = -2 or x = -3"
  ],
  "key_concepts": ["Factoring", "Zero Product Property"],
  "estimated_difficulty": "Easy"
}

// 1. User uploads image (JPG, PNG, HEIC)
// 2. Convert to base64
const base64Image = fs.readFileSync(file.path, 'base64');

// 3. Send to Claude Vision API
const response = await anthropic.messages.create({
  model: "claude-3-5-sonnet-20241022",
  messages: [{
    role: "user",
    content: [
      {
        type: "image",
        source: {
          type: "base64",
          media_type: "image/jpeg",
          data: base64Image
        }
      },
      {
        type: "text",
        text: "Extract and solve this problem"
      }
    ]
  }]
});

// Generate unique share token
const shareToken = uuidv4();
const shareUrl = `https://quiz.inspir.uk/doubt/shared/${shareToken}`;

// Anyone with link can view solution
// No account required

​

Other AI Features

​

Gamification System

​

Study Streaks

// Users earn streaks by studying daily
// Streak increments when user:
// - Completes a quiz
// - Solves a doubt
// - Creates flashcards
// - Uses any learning tool

const updateStreak = async (userId) => {
  const lastActivity = await getLastActivity(userId);
  const today = new Date();
  
  if (isConsecutiveDay(lastActivity, today)) {
    await incrementStreak(userId);
  } else if (!isSameDay(lastActivity, today)) {
    await resetStreak(userId);
  }
};

• Visual 🔥 flame icon grows with streak length
• Leaderboard ranking based on streaks
• Badges awarded at milestones (7 days, 30 days, 100 days)
• Streak recovery: Miss 1 day? Use a streak freeze (earned every 7 days)

​

XP & Leveling

-- Users earn XP for actions:
CREATE TABLE xp_events (
  action TEXT,
  xp_reward INTEGER
);

INSERT INTO xp_events VALUES
  ('quiz_completed', 10),
  ('quiz_perfect', 25),
  ('doubt_solved', 15),
  ('flashcard_set_completed', 20),
  ('daily_goal_met', 30),
  ('streak_milestone', 50);

• Level 1: 0 XP (Beginner)
• Level 2: 100 XP (Apprentice)
• Level 3: 250 XP (Scholar)
• Level 4: 500 XP (Expert)
• Level 5+: Exponential scaling

​

Leaderboards

• Global: Top users by XP
• Weekly: Most active this week
• Streaks: Longest current streaks
• Category: Top in each subject area

​

Security & Privacy

​

Authentication

// JWT-based authentication
import jwt from 'jsonwebtoken';

const token = jwt.sign(
  { userId, email },
  process.env.JWT_SECRET,
  { expiresIn: '7d' }
);

• Passwords hashed with bcrypt (10 salt rounds)
• JWT tokens expire after 7 days
• Refresh tokens for extended sessions
• Supabase Auth for OAuth providers

​

Data Protection

• Row Level Security (RLS): Users can only access their own data
• HTTPS Only: All communication encrypted
• Rate Limiting: Prevents abuse and DDoS
• Input Validation: All user input sanitized
• File Upload Security: Type and size validation

​

Privacy

• No tracking cookies: Only essential cookies for authentication
• Data deletion: Users can delete account + all data
• Content privacy: Study materials never shared without permission
• AI processing: Content sent to Claude API is not used for training

​

Performance Optimizations

​

Developer Resources

# Backend
cd backend
cp .env.example .env
npm install
npm run dev

# Frontend
cd frontend
cp .env.example .env
npm install
npm run dev

# Backend .env
ANTHROPIC_API_KEY=your_claude_api_key
SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
JWT_SECRET=your_jwt_secret_min_32_chars
FRONTEND_URL=http://localhost:5173

# Frontend .env
VITE_API_URL=http://localhost:3000
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

​

What’s Next?