🔍 Deploy Your Own Result Viewer – Full Setup Guide

 Do you need an automated result-checking system? With the Result Viewer project, you can easily set up your own exam result portal for free!

This guide will walk you through deploying the project from GitHub to Render (or any hosting platform), ensuring you follow MIT License rules (i.e., you cannot copy or sell it directly).

🔗 GitHub Repository: Result Viewer

---

📌 What You Will Learn

✅ How to download & modify the source code.
✅ How to deploy it on Render (Free 24/7 Hosting).
✅ How to connect it with your own Google Sheets data.

---

🚀 Step 1: Download the Result Viewer Project

🔹 Option 1: Download as ZIP

1. Visit GitHub Repository.
2. Click on the Code button and select Download ZIP.
3. Extract the ZIP file on your computer.

🔹 Option 2: Clone via Git (For Developers)
If you are comfortable with Git, you can use the command:

git clone https://github.com/khubaybv2/result_viewer.git

---

🛠️ Step 2: Modify It for Your Own Use

Since this project is licensed under MIT License, you are free to use and modify it but must follow these rules:

✅ What You Can Do:

✔ Change the branding, styles, and layout to match your needs.
✔ Deploy it on your own school, coaching, or personal website.
✔ Use it for free, keeping the original author credit.

❌ What You CANNOT Do:

🚫 Copy-paste it and sell it as your own product.
🚫 Remove the author credit from the code.

---

🌐 Step 3: Deploy to Render (Free 24/7 Hosting)

1️⃣ Sign up on Render:

• Go to Render and create a free account.

2️⃣ Create a New Web Service:

• Click New → Web Service.

3️⃣ Connect GitHub:

• Select "Connect Repository" and choose your forked result_viewer repo.

4️⃣ Set Deployment Options:

• Choose Static Site if it's front-end only, or Web Service for backend features.
• Enter the build command (if needed).

5️⃣ Deploy & Get Your Live Link!

• Click Deploy, and within minutes, your Result Viewer will be live online!

---

📊 Step 4: Link Your Google Sheets Data

Your results should be stored in Google Sheets, and this system will fetch them dynamically.

1️⃣ Create a Google Form for Student Results

• Create a Google Form that collects student details & results.
• Link it to a Google Sheets file (Form Responses).

2️⃣ Get Your Google Sheets Link

1. Open your Google Sheets file.
2. Click File → Share → Get Link.
3. Set "Anyone with the link can view".

3️⃣ Connect Google Sheets to the Script

• Open the script.js file in your project.
• Locate the Google Sheets URL section.
• Replace it with your own Google Sheets link.

Now, when users enter an Exam Number, the system will fetch results from your Google Sheets and display them! 🎉

---

💡 Conclusion

By following this guide, you have successfully:
✅ Deployed your own Result Viewer
✅ Connected it to Google Sheets
✅ Set it up on Render for free hosting

💡 Reminder: You can modify and use it but must respect the MIT License – do not copy, sell, or remove credit.

🔗 Start Now: GitHub Repository

Test Your Exam Submission and Result Viewing

✅ Submit Your Exam:

Click here to submit your exam

📊 View Exam Results:

Click here to check your results

💬 Need help? Comment below! 🚀