https://github.com/mayurasandakalum/ict-with-mayura
https://github.com/mayurasandakalum/ict-with-mayura
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mayurasandakalum/ict-with-mayura
- Owner: mayurasandakalum
- Created: 2025-08-09T13:46:22.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-08-23T07:49:20.000Z (4 months ago)
- Last Synced: 2025-08-24T09:33:59.063Z (4 months ago)
- Language: TypeScript
- Homepage: https://mayurasandakalum.github.io/ict-with-mayura/
- Size: 6.21 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# π ICT with ΰΆΈΰΆΊΰ·ΰΆ» (Mayura)
π Interactive ICT Learning Platform for Sri Lankan Students π
A modern, visual learning experience for Information and Communication Technology education
[](https://mayurasandakalum.github.io/ict-with-mayura)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](https://vitejs.dev/)
---
## π About the Project
**ICT with ΰΆΈΰΆΊΰ·ΰΆ»** is an innovative educational platform designed specifically for Sri Lankan students learning Information and Communication Technology. The platform combines modern web technologies with interactive mind mapping to create an engaging and visual learning experience.
### π― Key Features
- πΊοΈ **Interactive Mind Maps** - Visualize complex ICT concepts using advanced markmap technology
- π **Sinhala Language Support** - Full interface and content in Sinhala for local students
- π± **Responsive Design** - Works seamlessly on desktop, tablet, and mobile devices
- π¨ **Dark/Light Theme** - Choose your preferred learning environment
- π **Grade-wise Content** - Structured learning paths for grades 9-13
- π **Fast Performance** - Built with modern Vite and React for lightning-fast loading
### π Grade Coverage
| Grade Level | Content |
| -------------- | ---------------------------------- |
| 9 ΰ·ΰ·βΰΆ»ΰ·ΰΆ«ΰ·ΰΆΊ | Foundation ICT concepts |
| 10-11 ΰ·ΰ·βΰΆ»ΰ·ΰΆ«ΰ·ΰΆΊ | ΰ·ΰ·ΰΆΈΰ·ΰΆ±ΰ·βΰΆΊ ΰΆ΄ΰ·ΰ·
(O-Level) curriculum |
| 12-13 ΰ·ΰ·βΰΆ»ΰ·ΰΆ«ΰ·ΰΆΊ | ΰΆΰ·ΰ·ΰ· ΰΆ΄ΰ·ΰ·
(A-Level) advanced topics |
---
## π οΈ Tech Stack
- **Frontend**: React 18 + TypeScript
- **Build Tool**: Vite
- **Visualization**: Markmap (D3.js based mind mapping)
- **Styling**: CSS3 with custom themes
- **Routing**: React Router DOM
- **Database**: Supabase integration
- **Deployment**: GitHub Pages
---
## π Quick Start
### Prerequisites
- Node.js (v16 or higher)
- npm or yarn package manager
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/mayurasandakalum/ict-with-mayura.git
cd ict-with-mayura
```
2. **Install dependencies**
```bash
npm install
```
3. **Start development server**
```bash
npm run dev
```
4. **Open your browser**
Navigate to `http://localhost:5173`
### π§ Available Scripts
| Command | Description |
| ----------------- | ------------------------ |
| `npm run dev` | Start development server |
| `npm run build` | Build for production |
| `npm run preview` | Preview production build |
| `npm run deploy` | Deploy to GitHub Pages |
| `npm run lint` | Run ESLint |
---
## π Features in Detail
### Interactive Mind Maps
- **Visual Learning**: Complex ICT concepts presented as interactive mind maps
- **Zoom & Navigate**: Pan, zoom, and explore topics in detail
- **Hierarchical Structure**: Information organized in logical, easy-to-follow hierarchies
### Modern User Experience
- **Responsive Design**: Optimized for all screen sizes
- **Theme Support**: Switch between light and dark modes
- **Fast Loading**: Optimized performance with code splitting and lazy loading
### Educational Content
- **Curriculum Aligned**: Content matches Sri Lankan ICT curriculum
- **Progressive Learning**: Build knowledge step by step through grades
- **Visual Aid**: Mind maps help in better retention and understanding
---
## π Project Structure
```
ict-with-mayura/
βββ π public/
β βββ π data/ # Educational content (markdown files)
β βββ π assets/ # Images and static resources
βββ π src/
β βββ π components/ # Reusable React components
β βββ π pages/ # Main application pages
β βββ π contexts/ # React context providers
β βββ π hooks/ # Custom React hooks
β βββ π lib/ # Utility functions and configurations
βββ π package.json # Dependencies and scripts
βββ π vite.config.ts # Vite configuration
βββ π tsconfig.json # TypeScript configuration
```
---
## π€ Contributing
We welcome contributions from the community! Here's how you can help:
1. **Fork the repository**
2. **Create a feature branch** (`git checkout -b feature/amazing-feature`)
3. **Commit your changes** (`git commit -m 'Add some amazing feature'`)
4. **Push to the branch** (`git push origin feature/amazing-feature`)
5. **Open a Pull Request**
### π Areas for Contribution
- π Adding more educational content
- π Bug fixes and improvements
- π¨ UI/UX enhancements
- π Translation improvements
- π± Mobile experience optimization
---
## π Support & Contact
- π¨βπ« **Instructor**: Mayura Sandakalum
- π **Website**: [ICT with ΰΆΈΰΆΊΰ·ΰΆ»](https://mayurasandakalum.github.io/ict-with-mayura)
- π§ **Email**: Contact through the website
- π **Issues**: [GitHub Issues](https://github.com/mayurasandakalum/ict-with-mayura/issues)
---
## π License
This project is created for educational purposes. Please respect the intellectual property and use it responsibly for learning.
---
## π Acknowledgments
- πΊοΈ **Markmap.js** - For providing excellent mind mapping capabilities
- βοΈ **React Team** - For the amazing framework
- π **Vite** - For the blazing fast build tool
- π **Sri Lankan Education System** - For the curriculum guidance
---
π Made with β€οΈ for Sri Lankan ICT Students π
Empowering the next generation through visual and interactive learning
**[π Try it now!](https://mayurasandakalum.github.io/ict-with-mayura)**