# Project export: Rocket Tutors This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: Cal Hacks 12.0 - Tagline: In 36 hours, two coding beginners built Rocket Tutors using Claude, an AI co-developer. A free, interactive tutoring platform that helps every student reach new heights. - Devpost: https://devpost.com/software/rocket-tutors-from-zero-code-to-lift-off - GitHub: https://github.com/ninazhu321-lang/Rocket-Tutors.git - Video: https://www.youtube.com/embed/9sbk18Nq-Oc?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: 0 GitHub contributor(s) — ## Devpost submission (written by the team) ### Inspiration We saw that Secondary Math I is the most failed class in high school, so we wanted to change that. Many students in our local community struggle because they don't have affordable tutoring. We already had passionate tutors and motivated students, but we lacked a platform to connect them. This challenge is the heart of our CalHacks project. ### What it does Rocket Tutors is a free web platform that connects students who need help in math with volunteer tutors. Students can sign up based on their math needs, automatically get matched with a tutor, and view upcoming sessions on a personal dashboard. Additionally, donors can see how their contributions help students learn. ### How we built it We built Rocket Tutors with minimal prior coding experience. We mainly used HTML, CSS, and JavaScript, with creative help from Claude as well. First, we used a collaborative design to map out user flows and page layouts before implementing them. We created five pages: a landing page, a student sign-up page, a tutor-matching page, a student dashboard, and a donation page. ### Challenges we ran into Neither of us had very much web development experience going into CalHAcks, so it was pretty hard to figure things out at first. We also had to balance design, development, and study time, since we didn't have much time to prepare. ### Accomplishments we're proud of We built a fully functional multi-page web app in 36 hours. It's designed and implemented in a way that it is easy for the audience to understand. Additionally, we learned fundamental coding skills by collaborating with AI rather than just copy-pasting code. ### What we learned We learned that hackathons aren't just about who can build the coolest robot or has the most impactful project. Working with Claude taught us how to communicate clearly about what we wanted to build and how front-end technologies are able to work together. ### What's next : From Zero Code to Lift-Off After CalHacks, we plan to keep building Rocket Tutors into an even better platform by addting a backend database for better functionality and integrating video tutoring and scheduling features. We hope to turn this hackathon project into a real-world education platform that can help students everywhere to succeed. ## README (from the GitHub repository) # Rocket-Tutors ## Detected evidence (automated analysis) Indexed codebase: 25 recognized source files, 155 KB. - CSS (language) — detected in the code - HTML (language) — detected in the code - JavaScript (language) — detected in the code - React (technology) — detected in the code ## Codebase structure (from repository index) ### Files (26 of 26) ``` Hackathon/css/styles.css Hackathon/dashboard.html Hackathon/donate.html Hackathon/index.html Hackathon/js/main.js Hackathon/js/navigation.js Hackathon/package.json Hackathon/public/index.html Hackathon/README.md Hackathon/signup.html Hackathon/src/App.css Hackathon/src/App.jsx Hackathon/src/components/Footer.jsx Hackathon/src/components/Modal.jsx Hackathon/src/components/Navbar.jsx Hackathon/src/components/TutorCard.jsx Hackathon/src/context/AppContext.jsx Hackathon/src/data/tutorsData.js Hackathon/src/index.js Hackathon/src/pages/Dashboard.jsx Hackathon/src/pages/Donate.jsx Hackathon/src/pages/Home.jsx Hackathon/src/pages/Signup.jsx Hackathon/src/pages/Tutors.jsx Hackathon/tutors.html README.md ``` ### Dependencies - Hackathon/package.json: react@^18.2.0, react-dom@^18.2.0, react-router-dom@^6.20.0, react-scripts@5.0.1 ### Recent commits (newest first) - Add files via upload - Initial commit ## Key source files (fetched from GitHub, selected and truncated for size) ### Hackathon/package.json ``` { "name": "rocket-tutors", "version": "1.0.0", "description": "Free One-on-One Math Tutoring Powered by Donations", "private": true, "dependencies": { "react": "^18.2.0", "react-dom": "^18.2.0", "react-router-dom": "^6.20.0", "react-scripts": "5.0.1" }, "scripts": { "start": "react-scripts start", "build": "react-scripts build", "test": "react-scripts test", "eject": "react-scripts eject" }, "eslintConfig": { "extends": [ "react-app" ] }, "browserslist": { "production": [ ">0.2%", "not dead", "not op_mini all" ], "development": [ "last 1 chrome version", "last 1 firefox version", "last 1 safari version" ] } } ``` ### Hackathon/src/index.js ```javascript import React from 'react'; import ReactDOM from 'react-dom/client'; import './App.css'; import App from './App'; const root = ReactDOM.createRoot(document.getElementById('root')); root.render( ); ``` ### Hackathon/src/App.jsx ```javascript import React from 'react'; import { BrowserRouter as Router, Routes, Route } from 'react-router-dom'; import { AppProvider } from './context/AppContext'; import Home from './pages/Home'; import Signup from './pages/Signup'; import Dashboard from './pages/Dashboard'; import Tutors from './pages/Tutors'; import Donate from './pages/Donate'; function App() { return ( } /> } /> } /> } /> } /> ); } export default App; ``` ### Hackathon/js/main.js ```javascript // Rocket Tutors - Page-Specific Interactions // ===== SIGN UP PAGE ===== function initSignupPage() { initAuthTabs(); initSignInForm(); initSignUpForm(); } function initAuthTabs() { const signInTab = document.getElementById('signInTab'); const signUpTab = document.getElementById('signUpTab'); const signInForm = document.getElementById('signInForm'); const signupForm = document.getElementById('signupForm'); const switchToSignUp = document.getElementById('switchToSignUp'); const switchToSignIn = document.getElementById('switchToSignIn'); // Tab click handlers if (signInTab) { signInTab.addEventListener('click', function() { showSignIn(); }); } if (signUpTab) { signUpTab.addEventListener('click', function() { showSignUp(); }); } // Link handlers if (switchToSignUp) { switchToSignUp.addEventListener('click', function(e) { e.preventDefault(); showSignUp(); }); } if (switchToSignIn) { switchToSignIn.addEventListener('click', function(e) { e.preventDefault(); showSignIn(); }); } function showSignIn() { signInTab.classList.add('active'); signUpTab.classList.remove('active'); signInForm.style.display = 'block'; signupForm.style.display = 'none'; } function showSignUp() { signUpTab.classList.add('active'); signInTab.classList.remove('active'); signupForm.style.display = 'block'; signInForm.style.display = 'none'; } } function initSignInForm() { const signInForm = document.getElementById('signInForm'); const successMessage = document.getElementById('successMessage'); if (signInForm) { signInForm.addEventListener('submit', function(e) { e.preventDefault(); // Get form data const email = document.getElementById('signinEmail').value; const name = document.getElementById('signinName').value; // ALWAYS clear all previous data when signing in // This ensures no data from previous users carries over AppState.clearAll(); // Create fresh user profile for this sign in const newUser = { name: name, email: email, grade: 'college', subject: 'Algebra', availability: ['Monday 3-5pm'] }; // Set the new user with ZERO classes/sessions AppState.setUser(newUser); AppState.setSessions([]); // Show success message signInForm.style.display = 'none'; successMessage.classList.add('active'); }); } } function initSignUpForm() { const signupForm = document.getElementById('signupForm'); const successMessage = document.getElementById('successMessage'); if (signupForm) { signupForm.addEventListener('submit', function(e) { e.preventDefault(); // Clear any previous user data first AppState.clearAll(); // Get form data const formData = { name: document.getElementById('name').value, email: document.getElementById('email').value, grade: document.getElementById('grade').value, subject: document.getElementById('subject').value, availability: getSelectedAvailability() }; // Save fresh user data AppState.setUser(formData); // New users start with ZERO classes/sessions AppState.setSessions([]); // Show success message signupForm.style.display = 'none'; successMessage.classList.add('active'); }); } } function getSelectedAvailability() { const checkboxes = document.querySelectorAll('input[name="availability"]:checked'); return Array.from(checkboxes).map(cb => cb.value); } // ===== DASHBOARD PAGE ===== function initDashboardPage() { const user = AppState.getUser(); if (!user) { // Redirect to signup if not signed up window.location.href = 'signup.html'; return; } // Update welcome message const welcomeName = document.getElementById('welcomeName'); if (welcomeName) { welcomeName.textContent = user.name; } // Load tutor info loadTutorInfo(user); // Load sessions loadSessions(); // Load stats loadStats(); } function loadTutorInfo(user) { // Assign a tutor based on subject const tutorsBySubject = { 'Algebra': tutorsData[0], 'Geometry': tutorsData[3], 'Calculus': tutorsData[1], 'Statistics': tutorsData[4], 'Pre-Calculus': tutorsData[2], 'Trigonometry': tutorsData[2] }; const assignedTutor = tutorsBySubject[user.subject] || tutorsData[0]; const tutorAvatar = document.getElementById('tutorAvatar'); const tutorName = document.getElementById('tutorName'); const tutorSpecialty = document.getElementById('tutorSpecialty'); const tutorRating = document.getElementById('tutorRating'); const tutorBio = document.getElementById('tutorBio'); if (tutorAvatar) tutorAvatar.textContent = assignedTutor.avatar; if (tutorName) tutorName.textContent = assignedTutor.name; if (tutorSpecialty) tutorSpecialty.textContent = assignedTutor.subjects.join(', '); if (tutorBio) tutorBio.textContent = assignedTutor.bio; } function loadSessions() { [truncated — 8827 more characters] ``` ### Hackathon/tutors.html ```html Find a Tutor - Rocket Tutors

Find Your Perfect Tutor

Browse our expert tutors and request a session that fits your schedule

``` ### Hackathon/dashboard.html ```html My Dashboard - Rocket Tutors

Welcome back, Student! 👋

Here's an overview of your tutoring journey

Your Current Tutor

SJ

Dr. Sarah Johnson

Algebra, Geometry, Calculus

PhD in Mathematics with a passion for making complex concepts simple and fun.

Upcoming Sessions

Request New Session

Your Progress

6
Total Hours
2
Sessions Completed
``` ### Hackathon/donate.html ```html Donate - Rocket Tutors