Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

cpablomrod/reverseengineering

Repository files navigation

๐Ÿ” Reverse Engineering Academy

A comprehensive, interactive learning platform for reverse engineering, malware analysis, and cybersecurity research. Built with Next.js 15 and featuring a terminal-inspired dark theme.

Next.js React TypeScript Tailwind CSS License: MIT

๐ŸŽฏ Features

  • ๐Ÿ“š 6 Progressive Lessons - From foundations to advanced techniques
  • ๐Ÿ› ๏ธ Interactive Learning - Hands-on exercises with real samples
  • ๐ŸŒ™ Dark Theme - Professional hacker/cybersecurity aesthetic
  • ๐Ÿ“ฑ Responsive Design - Works on desktop, tablet, and mobile
  • ๐Ÿ’ป Terminal UI - Authentic command-line interface styling
  • ๐Ÿงญ Navigation System - Seamless lesson-to-lesson progression

๐ŸŽ“ Course Structure

Lesson Title Duration Difficulty Topics
1 Foundations 2 hours Beginner Introduction, tool setup, ethical guidelines
2 Assembly Fundamentals 3 hours Beginner CPU architecture, registers, instructions
3 Static Analysis 3 hours Intermediate Disassemblers, strings, file structure
4 File Formats 2.5 hours Intermediate PE/ELF/Mach-O, headers, sections
5 Dynamic Analysis 4 hours Intermediate Debuggers, runtime analysis, API monitoring
6 Advanced Static Analysis 6 hours Advanced IDA Pro, Ghidra, control flow analysis

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18.17 or later
  • npm or yarn package manager
  • Modern web browser

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/reverse-engineering-academy.git
    cd reverse-engineering-academy
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Run the development server

    npm run dev
    # or
    yarn dev
  4. Open your browser Navigate to http://localhost:3000

Building for Production

npm run build
npm start

๐Ÿ› ๏ธ Technology Stack

  • โš›๏ธ Framework: Next.js 15.5.3 with App Router
  • ๐Ÿ“ Language: TypeScript
  • ๐ŸŽจ Styling: Tailwind CSS
  • ๐Ÿงฉ Components: Custom React components
  • โœจ Animations: CSS animations and transforms
  • ๐Ÿ“ฆ Icons: Unicode emojis and symbols
  • ๐Ÿš€ Deployment: Vercel, Netlify, or any Node.js host

๐ŸŽจ Design Philosophy

๐Ÿ–ค Terminal Aesthetic

  • Dark color scheme (#0a0a0a background)
  • Green accent colors (#10b981)
  • Monospace fonts for code authenticity
  • Command-line inspired interactions

๐Ÿ“– Educational Focus

  • Progressive difficulty curve
  • Real-world examples and samples
  • Hands-on practical exercises
  • Professional tool integration

๐Ÿ“ Project Structure

reverse-engineering-academy/
โ”œโ”€โ”€ src/
โ”‚ โ”œโ”€โ”€ app/ # Next.js App Router pages
โ”‚ โ”‚ โ”œโ”€โ”€ globals.css # Global styles and dark theme
โ”‚ โ”‚ โ”œโ”€โ”€ layout.tsx # Root layout
โ”‚ โ”‚ โ”œโ”€โ”€ page.tsx # Homepage
โ”‚ โ”‚ โ””โ”€โ”€ lessons/ # Lesson pages
โ”‚ โ”‚ โ”œโ”€โ”€ foundations/
โ”‚ โ”‚ โ”œโ”€โ”€ assembly-basics/
โ”‚ โ”‚ โ”œโ”€โ”€ static-analysis/
โ”‚ โ”‚ โ”œโ”€โ”€ file-formats/
โ”‚ โ”‚ โ”œโ”€โ”€ dynamic-analysis/
โ”‚ โ”‚ โ””โ”€โ”€ 6-advanced-static-analysis/
โ”‚ โ””โ”€โ”€ components/ # Reusable components
โ”‚ โ”œโ”€โ”€ CodeBlock.tsx
โ”‚ โ”œโ”€โ”€ DownloadButton.tsx
โ”‚ โ””โ”€โ”€ Navigation.tsx
โ”œโ”€โ”€ public/ # Static assets
โ”‚ โ”œโ”€โ”€ exercises/ # Practice files
โ”‚ โ”œโ”€โ”€ samples/ # Analysis samples
โ”‚ โ””โ”€โ”€ guides/ # Reference materials
โ”œโ”€โ”€ exercises/ # Source code for exercises
โ””โ”€โ”€ README.md # This file

๐ŸŽ“ Learning Outcomes

After completing this course, students will be able to:

  • โœ… Set up and use professional reverse engineering tools
  • โœ… Read and understand assembly language
  • โœ… Perform static analysis of binary files
  • โœ… Conduct dynamic analysis and debugging
  • โœ… Analyze malware samples safely
  • โœ… Understand file formats and structures
  • โœ… Apply advanced RE techniques
  • โœ… Develop detection signatures (YARA rules)

๐Ÿ”ง Professional Tools Covered

๐Ÿ†“ Free Tools

  • Ghidra - NSA's open-source disassembler
  • Radare2/rizin - Command-line RE framework
  • x64dbg - Windows debugger
  • GDB - GNU debugger
  • YARA - Pattern matching engine

๐Ÿ’Ž Professional Tools

  • IDA Pro - Industry standard disassembler
  • Binary Ninja - Modern RE platform
  • Hex-Rays Decompiler - Advanced decompilation

๐ŸŒ Web-based Tools

  • Online disassemblers and analyzers
  • Sandbox environments for safe analysis
  • Threat intelligence platforms

๐Ÿ”’ Security & Ethics

โš–๏ธ Legal Framework

This platform is designed for educational purposes only. All content follows ethical guidelines:

  • ๐Ÿ“š Educational Use - Learning defensive security techniques
  • ๐Ÿ”ฌ Research Purpose - Understanding malware for protection
  • ๐Ÿ›ก๏ธ Defensive Focus - Building better security defenses
  • โš ๏ธ No Harm - Simulated samples that cannot cause damage

๐ŸŽฏ Ethical Guidelines

  • โœ… Use knowledge for defensive security
  • โœ… Respect applicable laws and regulations
  • โœ… Practice responsible disclosure
  • โœ… Never use skills maliciously
  • โŒ Do not attack systems you don't own
  • โŒ Do not distribute actual malware

๐Ÿค Contributing

We welcome contributions! Here's how you can help:

๐Ÿ› Bug Reports & Feature Requests

  • Open an issue on GitHub
  • Provide detailed descriptions
  • Include screenshots if applicable

๐Ÿ”ง Code Contributions

  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

๐Ÿ“ Content Guidelines

  • Ensure all content is educational and legal
  • Include practical examples and exercises
  • Follow existing lesson structure and styling
  • Maintain the dark terminal aesthetic
  • Test thoroughly before submitting

๐Ÿ“Š Development Scripts

# Development
npm run dev # Start development server with Turbopack
npm run build # Build production version
npm run start # Start production server
npm run lint # Run ESLint
# Testing
npm run type-check # TypeScript type checking

๐Ÿš€ Deployment Options

๐Ÿ”ฎ Vercel (Recommended)

# Connect GitHub repository to Vercel
# Automatic deployments on push to main

๐ŸŒ Netlify

# Build command: npm run build
# Publish directory: .next

๐Ÿณ Docker

# Build Docker image
docker build -t reverse-engineering-academy .
docker run -p 3000:3000 reverse-engineering-academy

๐Ÿ† Achievements System

Students can track their progress through:

  • ๐Ÿ“‹ Lesson Completion - Complete all 6 lessons
  • ๐Ÿ› ๏ธ Tool Mastery - Master key RE tools
  • ๐Ÿ” Sample Analysis - Analyze practice samples
  • ๐Ÿ… Certification - Earn completion certificates

๐ŸŒŸ Community

  • ๐Ÿ’ฌ GitHub Discussions - Ask questions and share knowledge
  • ๐Ÿฆ Twitter - Follow for updates and tips
  • ๐Ÿ“ง Newsletter - Monthly cybersecurity insights
  • ๐ŸŽฎ Discord - Real-time chat with other learners

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

Special thanks to:

  • NSA Ghidra Team - Open-source reverse engineering framework
  • Hex-Rays - IDA Pro and advanced decompilation
  • Radare2 Community - Unix-like reverse engineering framework
  • YARA Project - Pattern matching engine for malware research
  • Next.js Team - Excellent React framework
  • Tailwind CSS - Utility-first CSS framework
  • Cybersecurity Community - Continuous inspiration and knowledge sharing

๐Ÿ“ž Support & Contact

For questions, suggestions, or issues:

  • ๐Ÿ“ง GitHub Issues - Bug reports and feature requests
  • ๐Ÿ’ฌ Discussions - General questions and community help
  • ๐Ÿ”— LinkedIn - Professional networking
  • ๐Ÿฆ Twitter - Quick updates and tips

โš ๏ธ Educational Disclaimer
This platform is intended for cybersecurity education and research.
Users are responsible for complying with applicable laws and ethical guidelines.

๐Ÿ—๏ธ Built with โค๏ธ for the cybersecurity community

โญ Give us a star if this project helped you learn!

About

Reverse Engineering Lessons

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

AltStyle ใซใ‚ˆใฃใฆๅค‰ๆ›ใ•ใ‚ŒใŸใƒšใƒผใ‚ธ (->ใ‚ชใƒชใ‚ธใƒŠใƒซ) /