# Project export: Phantasm 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: CruzHacks 2026 - Tagline: Find out if your syllabus is a lie - Devpost: https://devpost.com/software/phantasm - GitHub: https://github.com/Pandawiththewin/phantasm - Video: https://www.youtube.com/embed/Hw5hV534KR0?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: 0 GitHub contributor(s) — ## Devpost submission (written by the team) No Devpost description available. ## README (from the GitHub repository)
GHBanner
# Run and deploy your AI Studio app This contains everything you need to run your app locally. View your app in AI Studio: https://ai.studio/apps/drive/1HKP1ALCtLo2THvt1QTvPdrZS_fB8VGop ## Run Locally **Prerequisites:** Node.js 1. Install dependencies: `npm install` 2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key 3. Run the app: `npm run dev` # phantasm ## Detected evidence (automated analysis) Indexed codebase: 15 recognized source files, 82 KB. - HTML (language) — detected in the code - React (technology) — detected in the code - TypeScript (language) — detected in the code - CSS (language) — claimed on Devpost, not found in the code - Google Gemini (technology) — claimed on Devpost, not found in the code ## Codebase structure (from repository index) ### Files (19 of 19) ``` .gitignore App.tsx components/CramTramView.tsx components/GhostInput.tsx components/PhantomRadio.tsx components/RatingCard.tsx components/SettingsModal.tsx components/SyllabusView.tsx index.html index.tsx metadata.json package.json README.md services/geminiService.ts services/openNoteService.ts services/redditService.ts tsconfig.json types.ts vite.config.ts ``` ### Dependencies - package.json: @google/genai@^1.37.0, @types/node@^22.14.0, @vitejs/plugin-react@^5.0.0, lucide-react@^0.562.0, react@^19.2.3, react-dom@^19.2.3, typescript@~5.8.2, vite@^6.2.0 ### Recent commits (newest first) - Update project files - first commit ## Key source files (fetched from GitHub, selected and truncated for size) ### package.json ``` { "name": "phantasm:-ghost-syllabus", "private": true, "version": "0.0.0", "type": "module", "scripts": { "dev": "vite", "build": "vite build", "preview": "vite preview" }, "dependencies": { "@google/genai": "^1.37.0", "lucide-react": "^0.562.0", "react": "^19.2.3", "react-dom": "^19.2.3" }, "devDependencies": { "@types/node": "^22.14.0", "@vitejs/plugin-react": "^5.0.0", "typescript": "~5.8.2", "vite": "^6.2.0" } } ``` ### index.tsx ```typescript import React from 'react'; import ReactDOM from 'react-dom/client'; import App from './App'; const rootElement = document.getElementById('root'); if (!rootElement) { throw new Error("Could not find root element to mount to"); } const root = ReactDOM.createRoot(rootElement); root.render( ); ``` ### App.tsx ```typescript import React, { useState } from 'react'; import { Loader2, Sparkles, AlertOctagon, GraduationCap, BookOpen, User, Ghost, ImagePlus, X, FileText, Film, Settings, TrainFront } from 'lucide-react'; import GhostInput from './components/GhostInput'; import SyllabusView from './components/SyllabusView'; import CramTramView from './components/CramTramView'; import RatingCard from './components/RatingCard'; import PhantomRadio from './components/PhantomRadio'; import SettingsModal from './components/SettingsModal'; import { fetchRedditData } from './services/redditService'; import { generateSyllabus, getProfessorRating } from './services/geminiService'; import { FetchStatus, ProfessorRating } from './types'; const App: React.FC = () => { if (!process.env.API_KEY) { return (

Reel Missing!

Please insert your GEMINI_API_KEY to begin the show.

); } const [university, setUniversity] = useState(''); const [courseCode, setCourseCode] = useState(''); const [professor, setProfessor] = useState(''); const [status, setStatus] = useState(FetchStatus.IDLE); const [syllabus, setSyllabus] = useState(null); const [rating, setRating] = useState(null); const [source, setSource] = useState<'LIVE' | 'MOCK'>('LIVE'); const [error, setError] = useState(null); const [selectedFile, setSelectedFile] = useState(null); const [isSettingsOpen, setIsSettingsOpen] = useState(false); // View State for Cram Tram const [view, setView] = useState<'DASHBOARD' | 'CRAM_TRAM'>('DASHBOARD'); const handleFileSelect = (e: React.ChangeEvent) => { if (e.target.files && e.target.files[0]) { setSelectedFile(e.target.files[0]); } }; const handleGenerate = async () => { if (!courseCode.trim() || !university.trim()) return; setStatus(FetchStatus.LOADING); setSyllabus(null); setRating(null); setError(null); try { const redditPromise = fetchRedditData(university, courseCode, professor); const ratingPromise = professor && professor.trim() ? getProfessorRating(university, professor) : Promise.resolve(null); const [redditRes, ratingRes] = await Promise.all([redditPromise, ratingPromise]); setSource(redditRes.source); setRating(ratingRes); const generatedSyllabus = await generateSyllabus(university, courseCode, redditRes.data, professor, selectedFile); setSyllabus(generatedSyllabus); setStatus(FetchStatus.SUCCESS); } catch (err: any) { console.error(err); setError(err.message || "The projector jammed (Connection failed)."); setStatus(FetchStatus.ERROR); } }; // If in Cram Tram mode, show that component exclusively if (view === 'CRAM_TRAM') { return ( setView('DASHBOARD')} /> ); } return (
setIsSettingsOpen(false)} /> {/* Top Header Card */}
{/* Title Block */}

PHANTASM

The Ghost Syllabus

{/* Controls */}
{}} disabled={status === FetchStatus.LOADING} placeholder="University" label="Location" icon={GraduationCap} />
{}} disabled={status === FetchStatus.LOADING} placeholder="Course ID" label="Subject" icon={BookOpen} />
{ const env = loadEnv(mode, '.', ''); return { server: { port: 3000, host: '0.0.0.0', }, plugins: [react()], define: { 'process.env.API_KEY': JSON.stringify(env.GEMINI_API_KEY), 'process.env.GEMINI_API_KEY': JSON.stringify(env.GEMINI_API_KEY) }, resolve: { alias: { '@': path.resolve(__dirname, '.'), } } }; }); ``` ### types.ts ```typescript export interface SyllabusData { courseCode: string; content: string; source: 'LIVE' | 'MOCK'; timestamp: string; } export enum FetchStatus { IDLE = 'IDLE', LOADING = 'LOADING', SUCCESS = 'SUCCESS', ERROR = 'ERROR' } export interface RedditResponse { data: { children: Array<{ data: { title: string; selftext: string; subreddit?: string; } }> } } export interface ProfessorRating { found: boolean; quality: string; difficulty: string; takeAgain: string; summary: string; name?: string; } // --- DOOMSDAY PROTOCOL TYPES --- export interface CramItem { timeblock: string; action: string; priority: string; notes: string; videoSuggestion?: { title: string; url: string; }; } export interface CramPlan { id?: number; // From OpenNote examType: string; // Midterm, Final, etc. totalHours: string; strategy: string; // The "Surgeon's" overall advice schedule: CramItem[]; createdTs?: number; } ``` ### index.html ```html Phantasm: The Ghost Syllabus
``` ### components/GhostInput.tsx ```typescript import React, { useState } from 'react'; import { Search, LucideIcon } from 'lucide-react'; interface GhostInputProps { value: string; onChange: (val: string) => void; onEnter: () => void; disabled?: boolean; placeholder?: string; icon?: LucideIcon; label?: string; } const GhostInput: React.FC = ({ value, onChange, onEnter, disabled, placeholder = "Enter...", icon: Icon = Search, label }) => { const [isFocused, setIsFocused] = useState(false); return (
{label && ( )}
onChange(e.target.value)} onKeyDown={(e) => e.key === 'Enter' && onEnter()} onFocus={() => setIsFocused(true)} onBlur={() => setIsFocused(false)} disabled={disabled} placeholder={placeholder} className="w-full pl-2 pr-3 py-3 bg-transparent border-none text-ink placeholder-silver font-bold font-typewriter focus:ring-0 focus:outline-none text-base uppercase" />
); }; export default GhostInput; ``` ### services/redditService.ts ```typescript import { RedditResponse } from '../types'; const MOCK_REVIEWS = [ "The midterm is identical to the practice exam. Don't waste time on the textbook, just grind the past papers.", "Warning: The professor loves trick questions on 'exceptions to the rule'. Memorize the edge cases.", "The group project is 40% of the grade. If you get bad teammates, go to office hours immediately.", "Lectures are recorded but the audio is terrible. You actually have to go to class to hear the examples.", "Avoid the 8am section, the TA for the afternoon slot is way more helpful with the labs.", "They curve the final heavily because the average is usually around 55%. Don't panic if you fail the first quiz.", "The textbook PDF is in the class Discord. Do not buy it.", "Week 7 is the 'Panic Zone'. The workload triples out of nowhere." ]; const getMockData = (university: string, courseCode: string, professor?: string): string => { const profString = professor ? ` taught by ${professor}` : ''; const header = `[SIMULATION MODE ACTIVE] Could not reach Reddit. Generated realistic student chatter for ${courseCode} at ${university}${profString}:`; const comments = MOCK_REVIEWS.map(review => { // Randomize slightly to make it feel less static return `- [r/${university}Student] ${review}`; }).join('\n'); return `${header}\n\n${comments}`; }; // Helper to process raw JSON into our string format const processRedditJson = (json: any): string => { if (!json.data || !json.data.children || json.data.children.length === 0) { throw new Error("No results found for this course."); } return json.data.children.map((child: any) => { const sub = child.data.subreddit_name_prefixed || child.data.subreddit || 'r/college'; const title = child.data.title; const text = child.data.selftext ? child.data.selftext.substring(0, 500) + "..." : "(No text content)"; return `[Source: ${sub}] Title: ${title}\nDiscussion: ${text}`; }).join('\n\n'); }; export const fetchRedditData = async (university: string, courseCode: string, professor?: string): Promise<{ data: string; source: 'LIVE' | 'MOCK' }> => { // Construct Query const queryParts = [university, courseCode]; if (professor && professor.trim()) queryParts.push(professor); const query = queryParts.join(' '); // Reddit API Endpoint const redditUrl = `https://www.reddit.com/search.json?q=${encodeURIComponent(query)}&sort=relevance&limit=10&type=link`; // Proxy List - We try them in order const proxies = [ // Proxy 1: corsproxy.io (Generally fast and reliable) { url: `https://corsproxy.io/?${encodeURIComponent(redditUrl)}`, transform: async (res: Response) => await res.json() }, // Proxy 2: allorigins.win (Reliable fallback, but needs JSON parsing of 'contents') { url: `https://api.allorigins.win/get?url=${encodeURIComponent(redditUrl)}`, transform: async (res: Response) => { const wrapper = await res.json(); return JSON.parse(wrapper.contents); } } ]; for (const proxy of proxies) { try { console.log(`Attempting fetch via proxy...`); const response = await fetch(proxy.url); if (!response.ok) throw new Error(`Status ${response.status}`); const json = await proxy.transform(response); const data = processRedditJson(json); return { data, source: 'LIVE' }; } catch (e) { console.warn(`Proxy failed:`, e); // Continue to next proxy loop } } // If all proxies fail: console.warn("All proxies failed. Switching to Mock Data."); return { data: getMockData(university, courseCode, professor), source: 'MOCK' }; }; ``` ### components/SettingsModal.tsx ```typescript import React, { useState, useEffect } from 'react'; import { X, BookLock, HelpCircle, Save, CheckSquare, Terminal, ExternalLink } from 'lucide-react'; import { HARDCODED_LEDGER_CONFIG } from '../services/openNoteService'; interface SettingsModalProps { isOpen: boolean; onClose: () => void; } const SettingsModal: React.FC = ({ isOpen, onClose }) => { const [ledgerUrl, setLedgerUrl] = useState(''); const [ledgerToken, setLedgerToken] = useState(''); const [status, setStatus] = useState<'IDLE' | 'SAVED'>('IDLE'); // Load from storage when modal opens, or fall back to hardcoded defaults useEffect(() => { if (isOpen) { setLedgerUrl(localStorage.getItem('phantasm_ledger_url') || HARDCODED_LEDGER_CONFIG.url); setLedgerToken(localStorage.getItem('phantasm_ledger_token') || HARDCODED_LEDGER_CONFIG.token); } }, [isOpen]); const handleSave = () => { localStorage.setItem('phantasm_ledger_url', ledgerUrl); localStorage.setItem('phantasm_ledger_token', ledgerToken); setStatus('SAVED'); setTimeout(() => { setStatus('IDLE'); onClose(); }, 1000); }; if (!isOpen) return null; return (

Link the Ledger

Connect to Memos Database

{/* Connection Form */}
setLedgerUrl(e.target.value)} placeholder="http://localhost:5230" className="w-full bg-paper border-[2px] border-ink p-2 font-typewriter text-sm rounded shadow-[2px_2px_0px_0px_rgba(10,10,10,1)] focus:outline-none focus:translate-x-[1px] focus:translate-y-[1px] focus:shadow-none transition-all" />
setLedgerToken(e.target.value)} placeholder="ey..." className="w-full bg-paper border-[2px] border-ink p-2 font-typewriter text-sm rounded shadow-[2px_2px_0px_0px_rgba(10,10,10,1)] focus:outline-none focus:translate-x-[1px] focus:translate-y-[1px] focus:shadow-none transition-all" />
{/* Setup Guide */}

No Database? Run this:

docker run -d -p 5230:5230 neosmemo/memos:stable

1. Run the command above in your terminal.

2. Open http://localhost:5230 to create your admin account.

3. Go to Settings → Access Tokens to generate your key.

View Official Memos Documentation
); }; export default SettingsModal; ``` ### services/openNoteService.ts ```typescript import { CramPlan } from '../types'; export interface OpenNoteConfig { serverUrl: string; token: string; } export const HARDCODED_LEDGER_CONFIG = { url: "http://localhost:5230", token: "eyJhbGciOiJIUzI1NiIsImtpZCI6InYxIiwidHlwIjoiSldUIn0.eyJuYW1lIjoiUGFuZGF3aXRodGhld2luIiwiaXNzIjoibWVtb3MiLCJzdWIiOiIxIiwiYXVkIjpbInVzZXIuYWNjZXNzLXRva2VuIl0sImV4cCI6MTc3MTM0Mjg2NywiaWF0IjoxNzY4NzUwODY3fQ.8-STI2MUqTA0jp1AowKfjyr1dkAYetb1NDz-YUzsDFc" }; const getConfig = (): OpenNoteConfig => { return { serverUrl: localStorage.getItem('phantasm_ledger_url') || HARDCODED_LEDGER_CONFIG.url, token: localStorage.getItem('phantasm_ledger_token') || HARDCODED_LEDGER_CONFIG.token }; }; // Helper to format URL const getApiUrl = (baseUrl: string): string => { let url = baseUrl.trim(); if (url.endsWith('/')) url = url.slice(0, -1); if (!url.startsWith('http')) url = `https://${url}`; if (!url.endsWith('/api/v1/memos')) { return `${url}/api/v1/memos`; } return url; }; // Helper to handle Memos API response structure variation // Some versions return [], others { memos: [] }, others { data: [] } const getMemosList = (json: any): any[] => { if (!json) return []; if (Array.isArray(json)) return json; if (json.memos && Array.isArray(json.memos)) return json.memos; if (json.data && Array.isArray(json.data)) return json.data; return []; }; export interface Whisper { id: number; content: string; createdTs: number; } export const fetchWhispers = async (courseCode: string): Promise => { const config = getConfig(); if (!config.token) return []; const apiUrl = getApiUrl(config.serverUrl); const tag = courseCode.replace(/\s+/g, ''); try { const response = await fetch(`${apiUrl}?limit=100`, { headers: { 'Authorization': `Bearer ${config.token}`, } }); if (!response.ok) return []; const rawData = await response.json(); const data = getMemosList(rawData); const whispers = data.filter((memo: any) => memo.content && memo.content.includes('#Whisper') && memo.content.includes(`#${tag}`) ).map((memo: any) => ({ id: memo.id, content: memo.content .replace('#Whisper', '') .replace(`#${tag}`, '') .trim(), createdTs: memo.createdTs })); return whispers; } catch (error) { console.error("Failed to fetch whispers:", error); return []; } }; export const saveWhisper = async (courseCode: string, content: string): Promise => { const config = getConfig(); if (!config.token) throw new Error("Ledger not connected"); const apiUrl = getApiUrl(config.serverUrl); const tag = courseCode.replace(/\s+/g, ''); const memoContent = `${content}\n\n#Whisper #${tag}`; try { const response = await fetch(apiUrl, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${config.token}`, }, body: JSON.stringify({ content: memoContent, visibility: "PUBLIC" }) }); if (!response.ok) { throw new Error(`Server Error: ${response.statusText}`); } } catch (error) { console.error("OpenNote Export Failed:", error); throw error; } }; // --- CRAM TRAM (DOOMSDAY) METHODS --- export const fetchSurvivalPlans = async (courseCode: string): Promise => { const config = getConfig(); if (!config.token) return []; const apiUrl = getApiUrl(config.serverUrl); const tag = courseCode.replace(/\s+/g, ''); try { const response = await fetch(`${apiUrl}?limit=50`, { headers: { 'Authorization': `Bearer ${config.token}` } }); if (!response.ok) return []; const rawData = await response.json(); const data = getMemosList(rawData); // Filter for #SurvivalPlan const plans: CramPlan[] = data .filter((memo: any) => memo.content && memo.content.includes('#SurvivalPlan') && memo.content.includes(`#${tag}`) ) .map((memo: any) => { // Parse the JSON block inside the memo content // The memo format is: #SurvivalPlan #CourseCode\n```json\n{...}\n``` const jsonMatch = memo.content.match(/```json\n([\s\S]*?)\n```/); if (jsonMatch) { try { const plan = JSON.parse(jsonMatch[1]); return { ...plan, id: memo.id, createdTs: memo.createdTs }; } catch (e) { return null; } } return null; }) .filter((p: any) => p !== null); return plans; } catch (error) { console.error("Failed to fetch survival plans", error); return []; } }; export const saveSurvivalPlan = async (courseCode: string, plan: CramPlan): Promise => { const config = getConfig(); if (!config.token) throw new Error("Ledger not connected"); const apiUrl = getApiUrl(config.serverUrl); const tag = courseCode.replace(/\s+/g, ''); // Wrap the plan in markdown code block for Memos to render nicely (and for us to parse back) const memoContent = `#SurvivalPlan #${tag}\n\n**Protocol: ${plan.examType} (${plan.totalHours})**\n> ${plan.strategy}\n\n\`\`\`json\n${JSON.stringify(plan, null, 2)}\n\`\`\``; try { await fetch(apiUrl, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${config.token}`, }, body: JSON.stringify({ content: memoContent, visibility: "PUBLIC" }) }); } catch (error) { console.error("Failed to save survival plan", error); throw error; } }; ``` [5 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]