🚀 DLANGAMANDLA STUDIES — FULL MASTER BUILD PROMPT 📱 APP NAME DLANGAMANDLA Studies 🌍 REGION South Africa 📧 OFFICIAL EMAIL dlangamandlastudies1@gmail.com 🎨 STRICT COLOR SYSTEM (DO NOT BREAK) Use ONLY: • Green • Brown • Black • White • Gray • Yellow DO NOT USE: • Blue • Red • Purple • Any other colors 🖼 BACKGROUND / WALLPAPER RULE • Use the uploaded wallpaper image as the main background • Apply it to: • Home page • Login page • Profile page • Subject pages • All screens • Add a dark overlay (20–40%) to ensure text readability 🎬 SPLASH SCREEN • Full-screen video (uploaded) • Must: • Auto-play • NOT be skippable • Play fully • After video ends → Navigate to PIN login • Add smooth fade transition 🔐 AUTHENTICATION SYSTEM Registration Fields: • Full Name • Grade • Email • Phone Number • Create 4-digit PIN • Confirm PIN • Enable fingerprint (optional) • Accept Terms checkbox Rules: • Encrypt (hash) PIN • Store securely in database Login • Enter PIN • OR fingerprint unlock • “Forgot PIN” → Admin reset 👤 PROFILE SYSTEM • Default profile image if user has none • User can upload custom image • Display: • Name • Grade • Email • Profile picture 🏠 HOMEPAGE STRUCTURE (VERY IMPORTANT) Homepage MUST show ALL: 📚 SUBJECT BUTTONS • English • Mathematics • Life Sciences • Physical Sciences • Agricultural Sciences • isiXhosa Home Language 🛠 TOOL BUTTONS • AI Assist • Calendar • Diary • Timetable • Notes • Donate • Contact Us • Settings • Logout 🌐 CHANNEL SECTION Title: DLANGAMANDLA Channels Buttons MUST be visible: ▶ YouTube https://youtube.com/@dlangamandlastudies?si=pUhWYJglPXe43cQ9 💬 WhatsApp https://whatsapp.com/channel/0029Vb75nTa2P59pPmKcSw1N 📸 Instagram https://www.instagram.com/dlangamandla_studies1?igsh=OXd0c25mdm92eDFw 📘 Facebook https://www.facebook.com/profile.php?id=61588152576719 🎵 TikTok https://www.tiktok.com/@dlangamandla.stud?_r=1&_t=ZS-95mwiSYxxI2 🔗 CHANNEL BUTTON FUNCTION When any channel button is clicked: • Open link instantly • Open external app if installed • Otherwise open browser • NO confirmation popups • NO internal webview 🤖 AI ASSIST SYSTEM • Icon = uploaded cartoon logo • Features: • Answer questions • Explain topics • Help with essays • Study assistance Fallback message: “Still need help? Contact dlangamandlastudies1@gmail.com” 📅 CALENDAR • Monthly view • Add events • View deadlines 📔 DIARY • Add entries • Edit/delete • Private storage 🕒 TIMETABLE • Weekly planner • Add subjects • Save per user 📝 NOTES • Create notes • Edit/delete • Organized by subject 💳 DONATION SYSTEM Use PayFast integration. Options: • R20 • R50 • R100 • Custom amount Flow: • Select amount • Redirect to PayFast • Complete payment • Return success 📄 AUTO PDF RECEIPT After payment: Generate receipt with: • Receipt number • Donor name • Amount • Transaction reference • Date • Email Text: “This is an auto-generated receipt and does not require a signature.” Allow: • Download • Store in database 👨‍💼 ADMIN DASHBOARD Admin email: dlangamandlastudies1@gmail.com Admin can: • View users • Block users • Reset PIN • Upload documents • Delete documents • View donations • Download reports • View AI usage 🛡 SECURITY • HTTPS • Encrypted PIN • Role-based admin • Secure payments (ITN verification) 🧱 UI STYLE • Rounded buttons • Dark theme with green/yellow accents • Smooth animations • Clean layout 🏁 FINAL OUTPUT REQUIREMENTS The generated app MUST include: ✔ Splash video ✔ Login system ✔ Profile system ✔ Homepage with ALL buttons ✔ Channel section (working links) ✔ Subject archive ✔ AI Assist ✔ Calendar ✔ Diary ✔ Timetable ✔ Notes ✔ Donation system ✔ Auto PDF receipt ✔ Admin dashboard 🏆 FINAL RESULT This must generate: A fully working AI-powered South African study platform NOT a demo NOT a prototype A working MVP system Alright 👑🔥 — now we’re refining your system into a clear, realistic, builder-ready MVP prompt that includes everything you just added without breaking how real apps actually work. I’m going to slightly correct one important thing first: 👉 An app builder cannot automatically download all documents from external websites (like government sites) without permission or backend scraping. 👉 The correct approach is: • Link to documents OR • Upload/store them in your app database (Firebase / storage) • Then open them inside the app (in-app viewer) I’ll build your prompt the right way so it actually works. Green, Brown, Black, White, Gray, Yellow NO other colors allowed 🖼 BACKGROUND Use uploaded wallpaper on ALL pages Add dark overlay for readability 🎬 SPLASH SCREEN • Play uploaded video fully • No skip • After video → go to PIN login 🔐 AUTH SYSTEM • Register (Name, Grade, Email, Phone, PIN) • Login with PIN or fingerprint • PIN must be encrypted 🏠 HOMEPAGE Must display: 📚 SUBJECTS • English • Mathematics • Life Sciences • Physical Sciences • Agricultural Sciences • isiXhosa HL 🛠 TOOLS • AI Assist • Calendar • Diary • Timetable • Notes • Donate • University Prospectus 🌐 CHANNELS (AUTO OPEN LINKS) • YouTube → https://youtube.com/@dlangamandlastudies?si=pUhWYJglPXe43cQ9 • WhatsApp → https://whatsapp.com/channel/0029Vb75nTa2P59pPmKcSw1N • Instagram → https://www.instagram.com/dlangamandla_studies1?igsh=OXd0c25mdm92eDFw • Facebook → https://www.facebook.com/profile.php?id=61588152576719 • TikTok → https://www.tiktok.com/@dlangamandla.stud?_r=1&_t=ZS-95mwiSYxxI2 Rule: 👉 Click = open instantly (external app/browser) 📚 SUBJECT PAGE STRUCTURE (VERY IMPORTANT) Each subject must ONLY have these 4 sections: 1️⃣ Past Question Papers (2008–2025) Instruction: • Integrate past papers from: https://www.education.gov.za/Curriculum/NationalSeniorCertificate(NSC)Examinations/NSCPastExaminationpapers.aspx • DO NOT redirect user away from app • Documents must open inside the app (PDF viewer) Implementation: • Either: • Upload PDFs into app storage OR • Use embedded document viewer (WebView PDF mode) 2️⃣ Subject Chat Group Features: • Create group using phone numbers • Add learners + teacher • Send: • Text messages • Voice notes • Requires internet 3️⃣ Subject Live Sessions Features: • Teachers can: • Start live video session • Use camera + microphone • Learners can: • Join live • Watch sessions 4️⃣ Notes • Write notes • Edit notes • Delete notes • Saved per subject 🎓 UNIVERSITY PROSPECTUS PAGE Create a page called: 🎓 University Prospectus Source: https://universityqualifications.co.za/undergraduate/pdf-prospectus Requirements: • Display list of universities • Each university opens its prospectus • PDFs must open inside the app (NOT browser) 🤖 AI ASSIST • Icon = your logo • Can: • Answer questions • Help with homework • Explain topics Fallback: “Contact dlangamandlastudies1@gmail.com” 💳 PAYMENT SYSTEM (MANUAL – CAPITEC) Payment Details: Bank: Capitec Account Number: 2501380866 Account Holder: E HLANJWA 💰 PAYMENT FLOW • User clicks “Donate / Pay” • Show bank details • User makes payment manually • After payment: 👉 User must upload Proof of Payment inside app 📤 PROOF SUBMISSION After upload: • Automatically open WhatsApp chat to: +27 67 918 8805 OR • Send proof directly inside app (upload system) 📄 OPTIONAL Generate simple receipt confirmation after approval 👨‍💼 ADMIN DASHBOARD Admin email: dlangamandlastudies1@gmail.com Admin can: • View users • Approve payments • View proof of payment • Upload documents • Delete documents • Manage subjects • Monitor activity 🛡 SECURITY • HTTPS • Encrypted PIN • Secure file uploads • Admin-only controls 🏁 FINAL REQUIREMENTS App MUST include: ✔ Splash video ✔ Login system ✔ Homepage with ALL buttons ✔ Channel links (auto open) ✔ Subject pages (4 sections ONLY) ✔ Internal PDF viewer ✔ Chat groups ✔ Live sessions ✔ Notes ✔ University prospectus page ✔ Manual Capitec payment system ✔ Proof of payment upload ✔ Admin dashboard 🏆 FINAL RESULT This must generate: A fully working South African study platform NOT a demo NOT partial A real MVP system 🔥 IMPORTANT (REALITY CHECK) This is powerful — but: 👉 Some builders (like anything.com) may NOT support: • Live video sessions • Real-time chat • File scraping If that happens, we will: ✔ Break it into modules ✔ Use Firebase ✔ Use APIs this is where my app becomes real, not just a concept. I’m going to give you a clean, working Firebase architecture for: • 💬 Subject Chat Groups • 🎥 Live Sessions (video classes) This is how real apps do it—simple, scalable, and actually buildable. 🔥 PART 1 — FIREBASE SETUP (FOUNDATION) Use Enable these services: • Authentication (Phone Number) • Firestore Database • Firebase Storage 🧑‍🎓 AUTH (IMPORTANT) Use phone number login so learners can: • Join groups using numbers • Identify each other 💬 PART 2 — SUBJECT CHAT GROUP SYSTEM 🗄️ DATABASE STRUCTURE (Firestore) groups/ groupId/ subject: "Mathematics" createdBy: userId members: [userId1, userId2] createdAt: timestamp messages/ messageId/ groupId: "math_group" senderId: "user123" text: "Explain question 2" voiceUrl: "optional" timestamp: timestamp 📱 FEATURES ✔ Create Group • User selects subject • Adds members (via phone numbers) • Creates group ✔ Send Text Message import { addDoc, collection, serverTimestamp } from "firebase/firestore"; await addDoc(collection(db, "messages"), { groupId: currentGroupId, senderId: currentUser.uid, text: messageText, timestamp: serverTimestamp() }); ✔ Receive Messages (Real-time) import { onSnapshot, query, where } from "firebase/firestore"; const q = query(collection(db, "messages"), where("groupId", "==", groupId)); onSnapshot(q, (snapshot) => { const messages = snapshot.docs.map(doc => doc.data()); setMessages(messages); }); 🎤 Voice Notes (IMPORTANT) Use Firebase Storage: // Upload voice note const uploadVoice = async (file) => { const ref = storage.ref(`voiceNotes/${Date.now()}`); await ref.put(file); const url = await ref.getDownloadURL(); return url; }; Save voiceUrl in message. 🎥 PART 3 — LIVE SESSIONS SYSTEM ⚠️ Firebase does NOT provide video calls directly. We integrate: 👉 OR 👉 ✅ BEST OPTION (Simple): JITSI No server needed. 📺 LIVE SESSION FLOW • Teacher clicks Start Live Session • App creates a room: roomName = subject + "_" + timestamp • Save session in Firestore 🗄️ DATABASE liveSessions/ sessionId/ subject: "Mathematics" hostId: "teacher123" roomName: "math_987654" isLive: true createdAt: timestamp 📡 START SESSION import { addDoc, collection } from "firebase/firestore"; await addDoc(collection(db, "liveSessions"), { subject: "Mathematics", hostId: currentUser.uid, roomName: "math_" + Date.now(), isLive: true, createdAt: new Date() }); 📺 JOIN SESSION (JITSI) Install: npm install react-native-jitsi-meet Then: import JitsiMeet, { JitsiMeetView } from "react-native-jitsi-meet"; JitsiMeet.call(roomName, { userInfo: { displayName: userName } }); 👀 SHOW LIVE SESSIONS const q = query(collection(db, "liveSessions"), where("isLive", "==", true)); onSnapshot(q, (snapshot) => { const sessions = snapshot.docs.map(doc => doc.data()); setLiveSessions(sessions); }); 🔐 PERMISSIONS (IMPORTANT) • Only teachers can start sessions • Learners can only join Add field: role: "teacher" | "student" 🛡️ FIRESTORE SECURITY RULES rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { match /messages/{message} { allow read, write: if request.auth != null; } match /groups/{group} { allow read, write: if request.auth != null; } match /liveSessions/{session} { allow read: if true; allow write: if request.auth != null; } } } 📱 FINAL USER EXPERIENCE 💬 CHAT • Join subject group • Chat instantly • Send voice notes • Real-time updates 🎥 LIVE SESSION • Teacher starts class • Learners see “LIVE” • Tap → Join instantly • Watch lesson live ⚠️ REALITY CHECK (IMPORTANT) If you use basic builders: ❌ They may NOT support: • Real-time chat • Live video 👉 For full system you’ll need: • React Native or Flutter • Firebase backend 🏆 FINAL RESULT You now have: ✔ Real-time messaging system ✔ Voice note support ✔ Live video classes ✔ Teacher/Student roles ✔ Scalable backend Good catch 👑—this is an important upgrade. Right now your system was hardcoded for a few subjects. We’re going to make it dynamic so it works for ALL South African CAPS subjects (present and future). This is how real platforms scale. 🇿🇦 GOAL Your app must support: 👉 ALL CAPS subjects from the 👉 Not just 6 subjects 👉 Admin can add/remove subjects anytime 👉 System auto-creates: • Chat groups • Live sessions • Notes • Past papers 🧠 STEP 1 — CREATE DYNAMIC SUBJECT SYSTEM 🔹 Firestore Collection Create: subjects/ 📄 Subject Document Structure Each subject = 1 document { "name": "Mathematics", "code": "MATH", "grade": "12", "hasPapers": true, "hasChat": true, "hasLive": true, "hasNotes": true, "createdAt": timestamp } ✅ Add ALL CAPS Subjects (Examples) Add documents like: • Mathematics • Mathematical Literacy • Physical Sciences • Life Sciences • Geography • History • Accounting • Business Studies • Economics • Tourism • Agricultural Sciences • Engineering Graphics & Design • Computer Applications Technology • Information Technology • Consumer Studies • Religion Studies • Dramatic Arts • Visual Arts • Music • Dance Studies • isiXhosa HL • isiZulu HL • Afrikaans HL • English HL • etc. 👉 You can keep adding anytime. 🏠 STEP 2 — HOMEPAGE AUTO-GENERATION Instead of hardcoding buttons: Use: const subjects = await getDocs(collection(db, "subjects")); Then: 👉 Display each subject as a button automatically 📚 STEP 3 — SUBJECT PAGE (AUTO STRUCTURE) When user clicks ANY subject: It must ALWAYS show: 1️⃣ Past Question Papers Dynamic path: documents/{subject}/papers/ 2️⃣ Subject Chat Group Each subject automatically has: groups/{subjectId} 3️⃣ Live Sessions Filter: where("subjectId", "==", selectedSubject) 4️⃣ Notes Stored per subject: notes/{subjectId}/{userId} 📁 STEP 4 — DOCUMENT SYSTEM (IMPORTANT) ⚠️ You CANNOT auto-download from DBE website directly. Instead: ✅ CORRECT METHOD Admin uploads papers into Firebase Storage: documents/ Mathematics/ 2008.pdf 2009.pdf ... 2025.pdf 📄 Firestore Reference documents/ docId: subject: "Mathematics" year: 2023 url: "firebase_link" 📖 APP BEHAVIOR When user clicks: 👉 Open PDF inside app (PDF viewer) 👉 NOT browser 🎓 STEP 5 — UNIVERSITY PROSPECTUS (DYNAMIC) Same system as subjects: Collection: universities/ Document: { "name": "University of Cape Town", "pdfUrl": "firebase_link" } 👉 Admin uploads PDFs 👉 App displays list 👉 Opens inside app 💬 STEP 6 — CHAT SYSTEM (AUTO PER SUBJECT) Instead of manual groups: Each subject = one main group: groups/ math_group physics_group Query: where("subjectId", "==", selectedSubject) 🎥 STEP 7 — LIVE SESSION SYSTEM (AUTO PER SUBJECT) When teacher starts live: { "subjectId": "Mathematics", "roomName": "math_12345", "isLive": true } 👉 Learners only see sessions for that subject 👨‍💼 STEP 8 — ADMIN CONTROL (VERY POWERFUL) Admin can: ✔ Add new subject ✔ Remove subject ✔ Upload papers ✔ Upload prospectus ✔ Control system without updating app 🏆 FINAL RESULT Your app becomes: ✔ Fully scalable ✔ Works for ALL SA subjects ✔ Future-proof ✔ Easy to manage ✔ No hardcoding ⚠️ REALITY CHECK If you keep hardcoding subjects: ❌ You will break the system later ❌ You cannot scale This dynamic system fixes that permanently. 🚀 NEXT STEP Do you want me to: 1️⃣ 2️⃣ 3️⃣ 4️⃣ Pick one 👑 Good—this is a core feature 👑🔥 If PDFs don’t open inside your app, the whole experience breaks. I’ll give you a real, working in-app PDF viewer system that fits your app (Firebase + Android/React Native style). 📄 GOAL When a learner taps a document: ✔ Opens inside the app ✔ Smooth scrolling ✔ Zoom support ✔ Fast loading ✔ Works with Firebase links 🧠 OPTION 1 (BEST) — Native PDF Viewer (Recommended) Use: 📦 STEP 1 — INSTALL npm install react-native-pdf npm install react-native-blob-util ⚙️ STEP 2 — LINK DEPENDENCIES For Android: npx react-native run-android (If using Expo → tell me, setup is different) 📁 STEP 3 — CREATE PDF VIEWER SCREEN Create file: PdfViewerScreen.js 💻 CODE import React from "react"; import { View, StyleSheet, ActivityIndicator } from "react-native"; import Pdf from "react-native-pdf"; export default function PdfViewerScreen({ route }) { const { pdfUrl } = route.params; return ( { console.log(`Loaded ${numberOfPages} pages`); }} onError={(error) => { console.log(error); }} activityIndicator={} /> ); } const styles = StyleSheet.create({ container: { flex: 1, backgroundColor: "black" }, pdf: { flex: 1 } }); 🔗 STEP 4 — NAVIGATE TO PDF When user clicks a document: navigation.navigate("PdfViewer", { pdfUrl: document.url }); 📂 STEP 5 — FIREBASE PDF LINKS Your Firestore document: { "subject": "Mathematics", "year": 2023, "url": "https://firebasestorage.googleapis.com/..." } ⚡ STEP 6 — FEATURES INCLUDED This viewer already supports: ✔ Zoom in/out ✔ Scroll pages ✔ Fast rendering ✔ Page detection ✔ Error handling 🎨 STEP 7 — MATCH YOUR APP DESIGN Apply your color rules: • Background: Black • Loader: Green • Accent: Yellow 🧠 OPTION 2 (LIGHTWEIGHT) — WebView (Backup) Use: Code: import { WebView } from "react-native-webview"; ⚠️ Downsides: • Slower • Depends on internet • Less control 🏆 FINAL USER EXPERIENCE • User opens subject • Sees list: Mathematics 2023 Paper Mathematics 2022 Paper • Clicks one • PDF opens instantly inside app • Scroll + zoom ⚠️ IMPORTANT PERFORMANCE RULES ✔ Compress PDFs (under 10MB) ✔ Use Firebase CDN links ✔ Cache frequently used files (advanced) 🚀 NEXT LEVEL (OPTIONAL) We can upgrade with: • 📥 Download for offline use • ⭐ Bookmark pages • 📝 Highlight text • 🔍 Search inside PDF • 📊 Track most opened papers 🔥 NEXT STEP Choose what we build next: 1️⃣ Upload all past papers properly into Firebase 2️⃣ Build subject document list UI 3️⃣ Add offline PDF downloads 4️⃣ Connect everything into full APK Tell me 👑 firebase setup step-by-step with exact clicks so you don’t get lost. We’re setting up: • Authentication (phone login) • Firestore (chat, users, live sessions) • Storage (voice notes, documents) Using 🚀 STEP 1 — CREATE FIREBASE PROJECT 👉 Do this: • Go to: https://console.firebase.google.com • Click “Add project” • Project name: DLANGAMANDLA Studies • Click Continue • Disable Google Analytics (for now) • Click Create project • Wait → Click Continue 📱 STEP 2 — ADD ANDROID APP • Click Android icon (🤖) • Enter: Android package name: com.dlangamandla.studies • App nickname: DLANGAMANDLA Studies • Click Register app 📥 Download Config • Click Download google-services.json • Save it (you’ll need it later) • Click Next → Next → Continue 🔐 STEP 3 — ENABLE AUTHENTICATION • Left menu → Click Authentication • Click Get Started 📞 Enable Phone Login • Click Sign-in method • Select Phone • Toggle Enable • Click Save 🧪 (IMPORTANT FOR TESTING) • Go to Settings → Phone numbers for testing • Add test number: +27XXXXXXXXX Code: 123456 🗄 STEP 4 — CREATE FIRESTORE DATABASE • Left menu → Click Firestore Database • Click Create database Choose Mode • Select: Start in test mode • Click Next • Choose location: southafrica-north (or closest region) • Click Enable 📁 STEP 5 — ENABLE STORAGE • Click Storage • Click Get Started • Click Next • Choose same location • Click Done 🔐 STEP 6 — FIRESTORE STRUCTURE (CREATE COLLECTIONS) Go to Firestore → Start collection 👤 USERS COLLECTION Collection name: users Add document: Fields: fullName: "Test User" phone: "+27..." grade: "12" role: "student" profileImage: "" createdAt: timestamp 💬 GROUPS COLLECTION groups Fields: subject: "Mathematics" createdBy: "userId" members: ["userId1", "userId2"] createdAt: timestamp 💬 MESSAGES COLLECTION messages Fields: groupId: "math_group" senderId: "userId" text: "Hello" voiceUrl: "" timestamp: timestamp 🎥 LIVE SESSIONS COLLECTION liveSessions Fields: subject: "Mathematics" hostId: "teacherId" roomName: "math_12345" isLive: true createdAt: timestamp 📦 STEP 7 — STORAGE STRUCTURE Go to Storage → Create folders: voiceNotes/ documents/ profileImages/ 🔐 STEP 8 — SECURITY RULES (IMPORTANT) Firestore Rules Go to: Firestore → Rules Replace with: rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { match /users/{userId} { allow read, write: if request.auth != null; } match /groups/{group} { allow read, write: if request.auth != null; } match /messages/{message} { allow read, write: if request.auth != null; } match /liveSessions/{session} { allow read: if true; allow write: if request.auth != null; } } } Click Publish Storage Rules Go to: Storage → Rules rules_version = '2'; service firebase.storage { match /b/{bucket}/o { match /{allPaths=**} { allow read, write: if request.auth != null; } } } Click Publish 🔗 STEP 9 — CONNECT TO YOUR APP You will use: npm install firebase Firebase Config Example import { initializeApp } from "firebase/app"; const firebaseConfig = { apiKey: "YOUR_KEY", authDomain: "YOUR_APP.firebaseapp.com", projectId: "YOUR_PROJECT_ID", storageBucket: "YOUR_BUCKET", messagingSenderId: "XXXX", appId: "XXXX" }; const app = initializeApp(firebaseConfig); 🏆 FINAL RESULT After this setup, your app can: ✔ Register users with phone numbers ✔ Store user data ✔ Create subject groups ✔ Send messages in real-time ✔ Upload voice notes ✔ Host live sessions ✔ Store documents ✔ Manage everything securely ⚠️ IMPORTANT NEXT STEP Firebase is now ready, but your app still needs: • UI screens (chat, live, subjects) • Payment system connection • PDF document upload system Good—this is a core feature 👑🔥 If PDFs don’t open inside your app, the whole experience breaks. I’ll give you a real, working in-app PDF viewer system that fits your app (Firebase + Android/React Native style). 📄 GOAL When a learner taps a document: ✔ Opens inside the app ✔ Smooth scrolling ✔ Zoom support ✔ Fast loading ✔ Works with Firebase links 🧠 OPTION 1 (BEST) — Native PDF Viewer (Recommended) Use: 📦 STEP 1 — INSTALL npm install react-native-pdf npm install react-native-blob-util ⚙️ STEP 2 — LINK DEPENDENCIES For Android: npx react-native run-android (If using Expo → tell me, setup is different) 📁 STEP 3 — CREATE PDF VIEWER SCREEN Create file: PdfViewerScreen.js 💻 CODE import React from "react"; import { View, StyleSheet, ActivityIndicator } from "react-native"; import Pdf from "react-native-pdf"; export default function PdfViewerScreen({ route }) { const { pdfUrl } = route.params; return ( { console.log(`Loaded ${numberOfPages} pages`); }} onError={(error) => { console.log(error); }} activityIndicator={} /> ); } const styles = StyleSheet.create({ container: { flex: 1, backgroundColor: "black" }, pdf: { flex: 1 } }); 🔗 STEP 4 — NAVIGATE TO PDF When user clicks a document: navigation.navigate("PdfViewer", { pdfUrl: document.url }); 📂 STEP 5 — FIREBASE PDF LINKS Your Firestore document: { "subject": "Mathematics", "year": 2023, "url": "https://firebasestorage.googleapis.com/..." } ⚡ STEP 6 — FEATURES INCLUDED This viewer already supports: ✔ Zoom in/out ✔ Scroll pages ✔ Fast rendering ✔ Page detection ✔ Error handling 🎨 STEP 7 — MATCH YOUR APP DESIGN Apply your color rules: • Background: Black • Loader: Green • Accent: Yellow 🧠 OPTION 2 (LIGHTWEIGHT) — WebView (Backup) Use: Code: import { WebView } from "react-native-webview"; ⚠️ Downsides: • Slower • Depends on internet • Less control 🏆 FINAL USER EXPERIENCE • User opens subject • Sees list: Mathematics 2023 Paper Mathematics 2022 Paper • Clicks one • PDF opens instantly inside app • Scroll + zoom ⚠️ IMPORTANT PERFORMANCE RULES ✔ Compress PDFs (under 10MB) ✔ Use Firebase CDN links ✔ Cache frequently used files (advanced) 🚀 NEXT LEVEL (OPTIONAL) We can upgrade with: • 📥 Download for offline use • ⭐ Bookmark pages • 📝 Highlight text • 🔍 Search inside PDF • 📊 Track most opened papers 🔥 NEXT STEP Choose what we build next: 1️⃣ Upload all past papers properly into Firebase 2️⃣ Build subject document list UI 3️⃣ Add offline PDF downloads 4️⃣ Connect everything into full APK Tell me 👑 Good—this is the real build phase 👑🔥 We’ll do all 4 steps properly, in order, so your app actually works end-to-end. 🚀 PART 1 — UPLOAD ALL PAST PAPERS TO FIREBASE Using + 📁 STEP 1 — ORGANIZE FILES (ON YOUR PC) Create folders like this: PastPapers/ Mathematics/ 2008.pdf 2009.pdf ... 2025.pdf PhysicalSciences/ LifeSciences/ English/ ... ☁️ STEP 2 — UPLOAD TO FIREBASE STORAGE • Go to Firebase Console • Click Storage • Click Upload folder Upload like this: documents/Mathematics/2008.pdf documents/Mathematics/2009.pdf ... 🔗 STEP 3 — GET DOWNLOAD URL For each file: • Click file • Click Get download URL • Copy link 🗄 STEP 4 — SAVE IN FIRESTORE Collection: documents Each document: { "subject": "Mathematics", "year": 2023, "title": "Mathematics Paper 1 2023", "url": "FIREBASE_DOWNLOAD_URL" } ⚡ PRO TIP Batch upload faster using Firebase CLI later (I can show you). 🎨 PART 2 — BUILD SUBJECT DOCUMENT LIST UI 📱 SCREEN: SubjectDocumentsScreen 💻 CODE import React, { useEffect, useState } from "react"; import { View, Text, FlatList, TouchableOpacity } from "react-native"; import { collection, query, where, getDocs } from "firebase/firestore"; export default function SubjectDocumentsScreen({ route, navigation }) { const { subject } = route.params; const [docs, setDocs] = useState([]); useEffect(() => { fetchDocs(); }, []); const fetchDocs = async () => { const q = query( collection(db, "documents"), where("subject", "==", subject) ); const snapshot = await getDocs(q); const list = snapshot.docs.map(doc => doc.data()); setDocs(list.sort((a, b) => b.year - a.year)); }; return ( item.year.toString()} renderItem={({ item }) => ( navigation.navigate("PdfViewer", { pdfUrl: item.url }) } > {item.title} )} /> ); } 📥 PART 3 — OFFLINE PDF DOWNLOAD SYSTEM 📦 INSTALL npm install react-native-fs 💾 DOWNLOAD FUNCTION import RNFS from "react-native-fs"; const downloadPDF = async (url, filename) => { const path = `${RNFS.DocumentDirectoryPath}/${filename}.pdf`; await RNFS.downloadFile({ fromUrl: url, toFile: path }).promise; alert("Downloaded successfully!"); }; 🔘 ADD BUTTON Inside document item: downloadPDF(item.url, item.title)}> Download 📂 OPEN OFFLINE FILE 🔗 PART 4 — CONNECT EVERYTHING (FULL FLOW) 🧭 NAVIGATION FLOW • Homepage → Subject button • Subject page → “Past Papers” • Documents list → Select paper • PDF Viewer → View / Download 📱 FINAL USER EXPERIENCE User taps: 👉 Mathematics → Sees papers 2008–2025 → Clicks 2023 → Opens instantly → Can download → Can open offline later 🏗️ PART 5 — BUILD APK (ANDROID) 📦 STEP 1 — INSTALL BUILD TOOLS Install: • Android Studio • SDK ⚙️ STEP 2 — BUILD APK cd android ./gradlew assembleRelease 📂 APK LOCATION android/app/build/outputs/apk/release/app-release.apk 📲 INSTALL • Transfer APK to phone • Install manually 🏆 FINAL RESULT Your app now has: ✔ Real past papers (2008–2025) ✔ Firebase storage system ✔ Clean document UI ✔ In-app PDF viewer ✔ Offline downloads ✔ Full navigation flow ✔ APK build ready ⚠️ REAL TALK At this point: 👉 You are no longer building a “simple app” 👉 You are building a real EdTech platform 🚀 NEXT LEVEL OPTIONS Now we can: 1️⃣ Auto-upload ALL DBE papers (semi-automated script) 2️⃣ Add search/filter by year 3️⃣ Add “Most Popular Papers” 4️⃣ Add bookmarks & highlights 5️⃣ Upload ALL subjects at once (bulk system) Tell me your next move 👑 Add : university prospectus page, AI page, subject page, Profile page. Make sure that all the study tools have their own functioning pages.Add ALL CAPS Subjects (Examples) Add documents like: • Mathematics • Mathematical Literacy • Physical Sciences • Life Sciences • Geography • History • Accounting • Business Studies • Economics • Tourism • Agricultural Sciences • Engineering Graphics & Design • Computer Applications Technology • Information Technology • Consumer Studies• Religion Studies • Dramatic Arts • Visual Arts • Music • Dance Studies • isiXhosa HL • isiZulu HL • Afrikaans HL • English HL. Remove the emojis for the features but put Icons that have relevant colours of the app for the features and systems . This picture that I am uploading right now is the logo of the app .The primary colours must be gradient. The 🧠 1. PROFILE PICTURES (GALLERY + LOCAL FILES) ✅ Add feature: Allow users to upload profile images from: • Gallery • Camera • Local device files 🔧 Implementation (Flutter / React Native idea) • Use file picker: • image_picker (mobile) • or expo-image-picker • Store image in: • Firebase Storage • Save URL in: • Firestore user profile Flow: • User taps profile • “Change photo” • Choose Gallery / Files / Camera • Upload → Firebase Storage • Save link → Firestore user doc 🔔 2. REMOVE NOTIFICATION BUTTON Action: • Delete notification icon/button from: • Bottom bar (if exists) • Header app bar • Any notification screen routes Backend: • You can also disable: • Firebase Cloud Messaging triggers (if not needed) 🎥 3. LIVE PAGE UPDATE (NO EMOJIS + ICON SYSTEM) Replace emojis with: Use icons with theme colors: FeatureIconColorLivelive_tvGreenViewer countgroupGrayChatchat_bubbleWhiteHostpersonYellow UI rule: • NO emojis anywhere in Live page • ONLY icons (Material / Lucide / Ionicons) 📡 4. STUDENTS CAN HOST THEIR OWN LIVE SESSIONS Add feature: Users can: • Start live class • Stream video/audio • Public or private mode Backend options: • Firebase + WebRTC (basic) • OR Agora / Twilio (better quality) Features: • Title live session • Subject tag (Math, Science, etc.) • Public / Private toggle • Chat enabled 🎙️ 5. VOICE NOTES + COMMUNITY CALLS (GROUP CHATS) Add in group chats: Voice notes: • Hold mic button → record • Send as audio file Community calls: • “Start group call” button • Join voice room (like Discord-lite) Tech: • WebRTC audio rooms OR Agora Voice SDK Features: • Mute / unmute • Raise hand • Leave call 📚 6. PAST PAPERS SYSTEM (2008–2025) Important reality check: I cannot directly download or host files from websites, but you can build a bulk ingestion system. 🔧 BEST IMPLEMENTATION (LEGAL + SCALABLE) Option A (Recommended): Create a backend scraper/importer: • Script pulls PDFs from DBE site: https://www.education.gov.za/Curriculum/NationalSeniorCertificate(NSC)Examinations/NSCPastExaminationpapers.aspx Structure: Firebase Storage: /papers/ /mathematics/ /2008/ /2009/ ... /2025/ Firestore: subject → year → paper links 📥 Features in app: • Filter by subject • Filter by year (2008–2025) • Search papers • Download button • Offline save 🌐 7. OPEN DOCUMENTS EXTERNALLY Add: • “Open externally” button Android: Use: • Intent.ACTION_VIEW (PDF) • Open with: • Google Drive • Adobe Reader Also add: • In-app PDF viewer fallback 🎓 8. UNIVERSITY PROSPECTUS DOWNLOAD SYSTEM From: https://universityqualifications.co.za/undergraduate/pdf-prospectus Feature: • “University Prospectus” section Function: • List universities • Download PDF • Open externally 🚫 9. REMOVE BOTTOM BAR MENU Action: • Delete BottomNavigationBar completely Replace with: • Side drawer (recommended) OR • Floating menu button 🤖 10. AI RESPONSE ERROR MESSAGE (CUSTOM IDENTITY) When AI fails, return EXACT message: “Hey I'm Tolo, Dlangamandla, Mchenge, Zulu, for now I'm having error and I can't help you with your question” Implementation: • Global fallback handler in AI service • Catch error / null response → replace output ⚙️ 11. SETTINGS PAGE ACCESS Add: • Route: /settings • Button: • Profile page → settings icon • Or side menu Settings include: • Profile • Downloads • Storage • Theme • Account 🧱 FINAL SYSTEM SUMMARY You are upgrading your app into: 📱 FULL EDUCATION PLATFORM FEATURES: • Profile image system (Firebase Storage) • Live classes with student hosting • Voice notes + group calls • Full DBE past papers (2008–2025 structured system) • External document support • University prospectus downloader • Clean icon-based UI (no emojis) • No bottom navigation bar • Settings page • Custom AI fallback personality ⚠️ IMPORTANT REAL-WORLD NOTE To fully support: • 2008–2025 DBE papers • Prospectus downloads You will need: • OR a scraper + manual moderation system Now add each and every page for each and every system that I requested. Make sure that all the buttons work it the app and in every page. This uploaded picture is the background wallpaper image of the app. Remove the yellow ring around the logo and enlarge the picture in the logo. Make the primary colours be more gradient. Make the app have only ventage classic and royal fonts 📱 📚 DLANGAMANDLA STUDIES APP — FULL PAGE STRUCTURE 🏠 1. HOME PAGE Daily dashboard Quick access to: Subjects Past Papers Live Classes AI Helper Announcements / updates (optional) 👤 2. PROFILE PAGE User name + details Profile picture upload (gallery / files / camera) Edit profile info View stats (papers downloaded, lives joined) ⚙️ 3. SETTINGS PAGE (NEW) Account settings Theme settings Storage settings Privacy controls Logout 📚 4. SUBJECTS PAGE All subjects list: Mathematics Physical Sciences Life Sciences English etc. Tap subject → opens paper archive 📄 5. PAST PAPERS PAGE (2008–2025 SYSTEM) Filter by: Year (2008–2025) Subject Paper type (Paper 1, 2, Memo) Features: Download PDF Open externally Offline save 📥 6. DOWNLOADS PAGE Saved PDFs Offline papers Prospectus downloads Delete / manage files 🎥 7. LIVE CLASSES PAGE (UPGRADED) List of live sessions Join live class Watch stream Features: NO emojis (icons only) Public live hosting by learners Create live session button Subject tagging Viewer list 🎬 8. CREATE LIVE PAGE (NEW) Start live stream Set: Title Subject Public/private Start broadcast Invite users 💬 9. GROUP CHATS PAGE Subject-based groups Messaging system Send: Text Images Voice notes (NEW) Join group calls 🎙️ 10. VOICE CALL / COMMUNITY ROOM PAGE (NEW) Live audio rooms Group voice calls Controls: Mute/unmute Leave call “Raise hand” system (optional) 🤖 11. AI ASSISTANT PAGE (TOLO) Chat-based AI helper Study assistance Past paper explanations Error fallback message: “Hey I'm Tolo, Dlangamandla, Mchenge, Zulu, for now I'm having error and I can't help you with your question” 📂 12. DOCUMENT VIEWER PAGE Open PDFs internally OR button: “Open externally” Used for: Past papers Prospectus Study files 🎓 13. UNIVERSITY PROSPECTUS PAGE List of universities Download prospectus PDFs Open externally Save offline 🔔 14. NOTIFICATIONS PAGE (REMOVED OR DISABLED) ❌ Removed completely (as requested) OR disabled system-wide 📊 15. ACTIVITY / PROGRESS PAGE (OPTIONAL BUT POWERFUL) Papers completed Subjects performance tracking Study streaks Download history 🧭 NAVIGATION SYSTEM UPDATE Since you removed the bottom bar: You now have: Side drawer navigation OR Floating menu button OR Home hub navigation tiles 🧠 FINAL STRUCTURE OVERVIEW Your app now becomes: CORE MODULES: Learning (Subjects + Papers) Streaming (Live classes) Communication (Chats + Voice calls) AI Tutor (Tolo) Resources (Prospectus + PDFs) User System (Profile + Settings)

DLANGAMANDLA Studies

About this game

Comments

Game facts