Welcome to StudyRoom 🎓

Collaborate with classmates, upload questions, and get AI-powered feedback and scoring tailored to your curriculum level — 11+, GCSE, A-Level, IB and more.

\n \n \n

📤

Upload Questions

Upload images (JPG/PNG) or PDFs. Our AI reads and analyses them instantly.

🤝

Collaborate Live

Work together on a shared answer box with your study group in real time.

🤖

AI Feedback

Get instant AI verification of answers with detailed explanations and solutions.

🏆

Smart Scoring

Scores weighted by level — 11+, GCSE, A-Level, Further Maths, IB, US Diploma.

\n\n\n

\n 🔑 ------\n 0 online\n \n 👑 Host\n

\n \n

👥 Participants

✉️ Invite Students

Share code or email below.

\n \n \n

\n \n

\n \n \n \n

\n\n \n

📄 Question

\n\n \n

\n \n \n

\n\n \n

📁

Click to upload your question

Supports JPEG, PNG, PDF

\n \n

✅ File uploaded

\n \n \n

\n \n

\n\n \n

\n Type or paste your question below\n \n

\n \n \n

✅ Question saved — all participants can now work on it.

\n \n

\n\n \n

⏳ Waiting for host to set a question…

✅ Question is ready

\n\n

\n \n

\n\n \n

✏️ Collaborative Answer Box

💡 Everyone in the room can type here. Changes sync automatically.

\n Team Answer\n \n

\n \n ⬅ Upload a question first\n

⏳ The host will submit your answer for AI review when ready.

✅ Answer submitted!

\n\n \n

\n\n\n\n\n\n\n\n\n`));\n\n// ── API: Create Room ──────────────────────────────────────────────────────────\napp.post(\"/api/rooms/create\", async (c) => {\n const { name, age, curriculumLevel, subject } = await c.req.json();\n if (!name || !age || !curriculumLevel || !subject) return c.json({ error: \"Missing fields\" }, 400);\n const roomId = genId(), code = genCode(), userId = genId();\n await sqlite.execute({ sql: `INSERT INTO sr_rooms (id,code,host_id,host_name,created_at,status,curriculum_level,subject) VALUES (?,?,?,?,?,?,?,?)`, args: [roomId, code, userId, name, new Date().toISOString(), \"waiting\", curriculumLevel, subject] });\n await sqlite.execute({ sql: `INSERT INTO sr_state (room_id,answer,updated_at) VALUES (?,?,?)`, args: [roomId, \"\", Date.now()] });\n await sqlite.execute({ sql: `INSERT INTO sr_participants (id,room_id,name,age,role,joined_at) VALUES (?,?,?,?,?,?)`, args: [userId, roomId, name, age, \"host\", new Date().toISOString()] });\n return c.json({ roomId, code, userId });\n});\n\n// ── API: Join Room ────────────────────────────────────────────────────────────\napp.post(\"/api/rooms/join\", async (c) => {\n const { code, name, age } = await c.req.json();\n if (!code || !name || !age) return c.json({ error: \"Missing fields\" }, 400);\n const room = (await sqlite.execute({ sql: `SELECT * FROM sr_rooms WHERE code=?`, args: [code] })).rows[0];\n if (!room) return c.json({ error: \"Room not found. Check the code and try again.\" }, 404);\n const userId = genId();\n await sqlite.execute({ sql: `INSERT INTO sr_participants (id,room_id,name,age,role,joined_at) VALUES (?,?,?,?,?,?)`, args: [userId, room.id, name, age, \"participant\", new Date().toISOString()] });\n return c.json({ roomId: room.id, userId });\n});\n\n// ── API: Manual Question ──────────────────────────────────────────────────────\napp.post(\"/api/rooms/:id/manual-question\", async (c) => {\n const id = c.req.param(\"id\");\n const { questionText } = await c.req.json();\n if (!questionText?.trim()) return c.json({ error: \"Missing question text\" }, 400);\n await sqlite.execute({ sql: `UPDATE sr_rooms SET question_text=?, question_file_name=NULL, question_file_type=NULL, question_data=NULL, status='active' WHERE id=?`, args: [questionText.trim(), id] });\n return c.json({ ok: true });\n});\n\n// ── API: Room State ───────────────────────────────────────────────────────────\napp.get(\"/api/rooms/:id/state\", async (c) => {\n const id = c.req.param(\"id\");\n const room = (await sqlite.execute({ sql: `SELECT id,code,host_id,host_name,status,curriculum_level,subject,question_file_name,question_file_type,question_text FROM sr_rooms WHERE id=?`, args: [id] })).rows[0];\n if (!room) return c.json({ error: \"Not found\" }, 404);\n const state = (await sqlite.execute({ sql: `SELECT answer,submission_result,solution FROM sr_state WHERE room_id=?`, args: [id] })).rows[0];\n const participants = (await sqlite.execute({ sql: `SELECT * FROM sr_participants WHERE room_id=?`, args: [id] })).rows;\n return c.json({ room, state, participants });\n});\n\n// ── API: Get Question ─────────────────────────────────────────────────────────\napp.get(\"/api/rooms/:id/question\", async (c) => {\n const id = c.req.param(\"id\");\n const room = (await sqlite.execute({ sql: `SELECT question_data,question_file_type,question_file_name FROM sr_rooms WHERE id=?`, args: [id] })).rows[0];\n if (!room || !room.question_data) return c.json({ error: \"No question\" }, 404);\n return c.json({ questionData: room.question_data, questionFileType: room.question_file_type, questionFileName: room.question_file_name });\n});\n\n// ── API: Upload ───────────────────────────────────────────────────────────────\napp.post(\"/api/rooms/:id/upload\", async (c) => {\n const id = c.req.param(\"id\");\n const { fileName, fileType, fileData } = await c.req.json();\n await sqlite.execute({ sql: `UPDATE sr_rooms SET question_file_name=?,question_file_type=?,question_data=?,status='active' WHERE id=?`, args: [fileName, fileType, fileData, id] });\n return c.json({ ok: true });\n});\n\n// ── API: Update Answer ────────────────────────────────────────────────────────\napp.post(\"/api/rooms/:id/answer\", async (c) => {\n const id = c.req.param(\"id\");\n const { answer } = await c.req.json();\n await sqlite.execute({ sql: `UPDATE sr_state SET answer=?,updated_at=? WHERE room_id=?`, args: [answer ?? \"\", Date.now(), id] });\n return c.json({ ok: true });\n});\n\n// ── API: Submit ───────────────────────────────────────────────────────────────\napp.post(\"/api/rooms/:id/submit\", async (c) => {\n const id = c.req.param(\"id\");\n const room = (await sqlite.execute({ sql: `SELECT * FROM sr_rooms WHERE id=?`, args: [id] })).rows[0];\n if (!room) return c.json({ error: \"Room not found\" }, 404);\n const state = (await sqlite.execute({ sql: `SELECT answer FROM sr_state WHERE room_id=?`, args: [id] })).rows[0];\n const participants = (await sqlite.execute({ sql: `SELECT age FROM sr_participants WHERE room_id=?`, args: [id] })).rows;\n const currLabel = CURR[room.curriculum_level as string] || String(room.curriculum_level);\n const ages = participants.map((p: any) => Number(p.age));\n const avgAge = ages.length ? Math.round(ages.reduce((a, b) => a + b, 0) / ages.length) : 14;\n const userAnswer = String((state as any)?.answer || \"\");\n const questionText = String(room.question_text || \"\");\n let messages: any[];\n if (room.question_data && String(room.question_file_type).startsWith(\"image/\")) {\n // Image upload\n messages = [{ role: \"user\", content: [\n { type: \"text\", text: `You are an expert academic tutor evaluating a student answer.\\nCurriculum: ${currLabel}\\nSubject: ${room.subject}\\nAverage age: ${avgAge}\\nStudent answer: \"${userAnswer}\"\\nRespond ONLY with this JSON:\\n{\"isCorrect\":true/false,\"feedback\":\"2-3 sentences\",\"score\":0-100,\"maxScore\":100,\"difficulty\":\"Easy/Medium/Hard/Very Hard\",\"curriculumMatch\":\"${currLabel}\"}` },\n { type: \"image_url\", image_url: { url: `data:${room.question_file_type};base64,${room.question_data}` } }\n ]}];\n } else if (questionText) {\n // Manual text question\n messages = [{ role: \"user\", content: `You are an expert academic tutor evaluating a student answer.\\nCurriculum: ${currLabel}\\nSubject: ${room.subject}\\nAverage student age: ${avgAge}\\n\\nQuestion: \"${questionText}\"\\nStudent answer: \"${userAnswer}\"\\n\\nRespond ONLY with this JSON:\\n{\"isCorrect\":true/false,\"feedback\":\"2-3 sentences explaining if correct and why\",\"score\":0-100,\"maxScore\":100,\"difficulty\":\"Easy/Medium/Hard/Very Hard\",\"curriculumMatch\":\"${currLabel}\"}` }];\n } else {\n // PDF fallback\n messages = [{ role: \"user\", content: `Expert tutor for ${currLabel}, subject: ${room.subject}.\\nStudent answer: \"${userAnswer}\"\\nRespond ONLY with JSON:\\n{\"isCorrect\":true/false,\"feedback\":\"2-3 sentences\",\"score\":0-100,\"maxScore\":100,\"difficulty\":\"Easy/Medium/Hard/Very Hard\",\"curriculumMatch\":\"${currLabel}\"}` }];\n }\n const completion = await openai.chat.completions.create({ model: \"gpt-4o-mini\", messages, max_tokens: 400 });\n let result: any = {};\n try { result = JSON.parse(completion.choices[0].message.content?.replace(/```json|```/g, \"\").trim() || \"{}\"); }\n catch { result = { isCorrect: false, feedback: \"AI could not evaluate. Please try again.\", score: 0, maxScore: 100, difficulty: \"Unknown\", curriculumMatch: currLabel }; }\n result.submittedAt = new Date().toISOString();\n await sqlite.execute({ sql: `UPDATE sr_state SET submission_result=?,updated_at=? WHERE room_id=?`, args: [JSON.stringify(result), Date.now(), id] });\n await sqlite.execute({ sql: `UPDATE sr_rooms SET status='submitted' WHERE id=?`, args: [id] });\n return c.json({ ok: true, result });\n});\n\n// ── API: Solution ─────────────────────────────────────────────────────────────\napp.post(\"/api/rooms/:id/solution\", async (c) => {\n const id = c.req.param(\"id\");\n const room = (await sqlite.execute({ sql: `SELECT * FROM sr_rooms WHERE id=?`, args: [id] })).rows[0];\n if (!room) return c.json({ error: \"Room not found\" }, 404);\n const currLabel = CURR[room.curriculum_level as string] || String(room.curriculum_level);\n const questionText = String(room.question_text || \"\");\n let messages: any[];\n if (room.question_data && String(room.question_file_type).startsWith(\"image/\")) {\n messages = [{ role: \"user\", content: [\n { type: \"text\", text: `You are an expert ${room.subject} tutor for ${currLabel}. Provide a clear numbered step-by-step solution to the question in the image. End with the final answer clearly stated.` },\n { type: \"image_url\", image_url: { url: `data:${room.question_file_type};base64,${room.question_data}` } }\n ]}];\n } else if (questionText) {\n messages = [{ role: \"user\", content: `You are an expert ${room.subject} tutor for ${currLabel}.\\n\\nQuestion: \"${questionText}\"\\n\\nProvide a clear, numbered step-by-step solution. Show all working. End with the final answer clearly stated. Be age-appropriate for ${currLabel} students.` }];\n } else {\n messages = [{ role: \"user\", content: `Expert ${room.subject} tutor for ${currLabel}. Provide a numbered step-by-step approach to solving typical ${room.subject} questions at ${currLabel} level. Be thorough and age-appropriate.` }];\n }\n const completion = await openai.chat.completions.create({ model: \"gpt-4o-mini\", messages, max_tokens: 800 });\n const solution = completion.choices[0].message.content || \"Solution unavailable.\";\n await sqlite.execute({ sql: `UPDATE sr_state SET solution=?,updated_at=? WHERE room_id=?`, args: [solution, Date.now(), id] });\n await sqlite.execute({ sql: `UPDATE sr_rooms SET status='solved' WHERE id=?`, args: [id] });\n return c.json({ ok: true, solution });\n});\n\n// ── API: Invite ───────────────────────────────────────────────────────────────\napp.post(\"/api/rooms/:id/invite\", async (c) => {\n const id = c.req.param(\"id\");\n const { email: toEmail, roomCode } = await c.req.json();\n const room = (await sqlite.execute({ sql: `SELECT * FROM sr_rooms WHERE id=?`, args: [id] })).rows[0];\n if (!room) return c.json({ error: \"Room not found\" }, 404);\n const currLabel = CURR[room.curriculum_level as string] || String(room.curriculum_level);\n try {\n await email({ to: toEmail, subject: `You've been invited to StudyRoom! 🎓`,\n text: `${room.host_name} invited you to a study session.\\nSubject: ${room.subject}\\nLevel: ${currLabel}\\nRoom Code: ${roomCode}`,\n html: `

🎓 You're invited to StudyRoom!

${room.host_name} invited you to a live study session.

Subject: ${room.subject} | Level: ${currLabel}

${roomCode}

Enter this code in StudyRoom to join. Good luck! 📚

`\n });\n return c.json({ ok: true });\n } catch (e: any) { return c.json({ error: e.message }, 500); }\n});\n\nexport default app.fetch;\n","deleted","label",[102],"permalink","https://www.val.town/x/MRPRRSIDENT/study-room/code/index.ts","extension","actionData","errors"]

Welcome to StudyRoom 🎓

Upload Questions

Collaborate Live

AI Feedback

Smart Scoring

✏️ Create a Study Room

🔗 Join a Study Room

🎓 You're invited to StudyRoom!