Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

198 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HSCStack πŸ“š

A curated resource platform for HSC & SSC students of Bangladesh β€” built by members, for everyone.

HSCStack is a lightweight, structured platform where verified members share academic resources β€” practicals, notes, PDFs, videos, and questions β€” organized by subject and chapter, so every HSC student can find what they need in one place.


🌟 What is HSCStack?

HSCStack is built for students preparing for the Higher Secondary Certificate (HSC) & Secoondary School Certificate (SSC) exams in Bangladesh. It brings together a trusted library of student-made resources, organized neatly by subject and chapter β€” no more digging through WhatsApp groups or random Facebook posts.

Browsing is open to everyone. But to contribute, you need to be an HSCStack member first β€” keeping the content quality high and the community trustworthy.


✨ Features

  • πŸ“‚ Subject Archive β€” Resources organized under subjects with visual themes and icons.
  • πŸ—‚οΈ Chapter-based Structure β€” Each subject has nested chapters (nodes) so you can find exactly what you need.
  • πŸ“„ Multiple Resource Types β€” Notes, PDFs, images, videos, and exam questions β€” all in one place.
  • πŸ”’ Members-Only Uploads β€” Only verified HSCStack members can contribute content.
  • πŸ› οΈ Admin Panel β€” Full control over subjects, chapters, and resources via a clean admin area.
  • ☁️ File Upload Support β€” Resources are stored and served from public storage.
  • πŸ†“ Free to Browse β€” No account needed to read or download resources.
  • πŸ“ Educational Blog β€” Read study tips, announcements, learning guides, and educational articles.

πŸ“š Resource Types

Type Description
Notes Handwritten or typed notes by fellow students
PDFs Formatted documents, guides, and reference sheets
Images Diagrams, charts, and visual study aids
Videos Classes from Youtube

πŸš€ Getting Started

For Students (Browsing)

  1. Visit HSCStack β€” no account needed.
  2. Pick your subject and chapter.
  3. Browse, read, or download any resource freely.

For Members (Contributing)

Only HSCStack members can upload resources. To become a member:

  1. Join at πŸ‘‰ hscstack.mvp.bd/join
  2. Once accepted, log in and go to the relevant subject and chapter.
  3. Upload your resource β€” add a title, type, and short description.
  4. Your contribution goes live after a quick admin review.

Why membership? We keep uploads member-only to maintain quality and ensure content is relevant, accurate, and trustworthy for all HSC students.


πŸ› οΈ Tech Stack

Layer Technology
Backend Laravel (PHP)
Frontend Vue.js via Inertia.js
Storage Public file storage
Admin Panel Built-in Laravel admin area

πŸ“– Developer Documentation

Additional documentation for developers:


🀝 Contributing to the Codebase

HSCStack is not open for general pull requests. To contribute code, you must be a core developer on the team.

To apply, join via πŸ‘‰ hscstack.mvp.bd/join β€” once your application is reviewed and accepted, we'll onboard you to the codebase.

Once you're a core developer:

  1. Clone the repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Commit your changes: git commit -m "Add: your feature"
  4. Push to your branch: git push origin feature/your-feature-name
  5. Open a Pull Request for review

πŸ“ Project Structure

hscstack/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ Models/             # Subject, Node, Resource models
β”‚   β”œβ”€β”€ Http/Controllers/   # Web + Admin controllers
β”‚   └── ...
β”œβ”€β”€ resources/
β”‚   β”œβ”€β”€ js/
β”‚   β”‚   β”œβ”€β”€ Pages/          # Inertia Vue pages
β”‚   β”‚   └── Components/     # Reusable Vue components
β”‚   └── views/              # Blade layouts
β”œβ”€β”€ routes/
β”‚   β”œβ”€β”€ web.php             # Public routes
β”‚   └── admin.php           # Admin routes
β”œβ”€β”€ public/storage/         # Uploaded files
β”œβ”€β”€ .env.example
└── README.md

🌍 Community Guidelines

HSCStack's value comes from the quality of what's shared. Please follow these rules:

  • βœ… Only upload content you created or have permission to share.
  • βœ… Keep everything relevant to the HSC Bangladesh curriculum.
  • βœ… Add clear titles and descriptions so others can find your resource.
  • ❌ Do not upload copyrighted textbooks or board materials without permission.
  • ❌ No spam, duplicate, or off-topic content.

Breaking these rules may result in content removal or membership revocation.


πŸ“¬ Contact & Support

Have a question, found a bug, or want to get involved?


πŸ“„ License

This project is licensed under the MIT License.


Made with ❀️ by HSC students, for HSC students πŸ‡§πŸ‡©

About

A curated resource platform for HSC & SSC students of Bangladesh β€” built by members, for everyone.

Resources

Contributing

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages