Add interactive website with search and responsive design

Author: Omar-Mega-Byte

.github/workflows/deploy.yml

@@ -0,0 +1,54 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches: [ "main", "master" ]
+  pull_request:
+    branches: [ "main", "master" ]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./
+          destination: ./_site
+      
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -2,6 +2,17 @@
 
 A comprehensive reference guide covering essential Java concepts needed to master Spring Framework.
 
+## 🌐 Interactive Website
+
+Visit our interactive website: **[https://omar-mega-byte.github.io/java-fundamentals-for-spring](https://omar-mega-byte.github.io/java-fundamentals-for-spring)**
+
+The website features:
+- 📱 Responsive design for all devices
+- 🔍 Search functionality across all modules
+- 📊 Progress tracking while reading
+- 🎯 Quick navigation between modules
+- ⚡ Fast loading and smooth animations
+
 ## 📚 Module Structure
 
 This guide is organized into focused modules, each covering key Java concepts essential for Spring development:
@@ -33,6 +44,10 @@ This guide is organized into focused modules, each covering key Java concepts es
 
 ## 🚀 Getting Started
 
+### Option 1: Interactive Website (Recommended)
+Visit our [interactive website](https://omar-mega-byte.github.io/java-fundamentals-for-spring) for the best learning experience with search, progress tracking, and responsive design.
+
+### Option 2: GitHub Repository
 Start with Module 1 if you want a complete review, or jump to specific modules based on your needs.
 
 Each module contains:
@@ -43,6 +58,34 @@ Each module contains:
 - Spring Framework relevance
 - Practice exercises
 
+## 🌐 Website Features
+
+The companion website includes:
+- **Responsive Design**: Works perfectly on desktop, tablet, and mobile
+- **Advanced Search**: Find modules and topics instantly
+- **Progress Tracking**: Visual progress indicator while reading
+- **Interactive Elements**: Smooth animations and hover effects
+- **Quick Navigation**: Jump between modules effortlessly
+- **SEO Optimized**: Easy to find and share
+
+### Hosting Your Own Website
+
+To set up GitHub Pages for this repository:
+
+1. **Enable GitHub Pages**:
+   - Go to repository Settings → Pages
+   - Source: "Deploy from a branch"
+   - Branch: `main`, Folder: `/ (root)`
+
+2. **Access your site**:
+   - Visit: `https://yourusername.github.io/repository-name`
+
+The website files included:
+- `index.html` - Main website structure
+- `style.css` - Professional styling and responsive design
+- `script.js` - Interactive features and animations
+- `_config.yml` - GitHub Pages configuration
+
 ## 🤝 Contributing
 
 We welcome contributions! Please see our [Contributing Guidelines](./CONTRIBUTING.md) for details on how to help improve this guide.

_config.yml

@@ -0,0 +1,44 @@
+title: Java Core Principles - Spring Preparation Guide
+description: A comprehensive reference guide covering essential Java concepts needed to master Spring Framework
+theme: minima
+plugins:
+  - jekyll-feed
+  - jekyll-sitemap
+  - jekyll-seo-tag
+
+# SEO settings
+author: Java Spring Fundamentals Guide
+social:
+  type: Organization
+  links:
+    - https://github.com/Omar-Mega-Byte/java-fundamentals-for-spring
+
+# GitHub Pages settings
+repository: Omar-Mega-Byte/java-fundamentals-for-spring
+github:
+  owner_name: Omar-Mega-Byte
+  repository_name: java-fundamentals-for-spring
+
+# Additional settings
+markdown: kramdown
+highlighter: rouge
+permalink: pretty
+
+# Collections (if you want to organize modules as collections)
+collections:
+  modules:
+    output: true
+    permalink: /:collection/:name/
+
+# Exclude files from processing
+exclude:
+  - README.md
+  - Gemfile
+  - Gemfile.lock
+  - node_modules
+  - vendor/
+  - .sass-cache/
+  - .jekyll-cache/
+  - gemfiles/
+  - package.json
+  - package-lock.json