.png){kind=link}
redteamX is the premier student-led cybersecurity club at Pandit Deendayal Energy University (PDEU). We are a collective of ethical hackers, security researchers, and cyber enthusiasts dedicated to offensive security, penetration testing, and red-teaming methodologies. Our mission is to cultivate a robust cybersecurity culture by providing hands-on experience in vulnerability assessment, exploit development, and secure coding practices.
This repository houses the source code for our official web portal—a digital manifestation of our club's ethos. It transcends a mere informational site by integrating an interactive, terminal-based user experience that immerses visitors in a simulated cyber environment from the moment they load the page.
- Virtual File System (VFS) Terminal: A fully interactive terminal component embedded on the homepage. Users can navigate a simulated directory structure and execute commands, bridging the gap between a standard website and a command-line interface.
- BYTE Terminal Mascot: A custom interactive pixel-art bot accessible by typing
bytein the terminal. The bot responds to various commands, changes moods dynamically, and provides an immersive cybersecurity AI experience. - Advanced Cyberpunk Aesthetics: A sleek dark-mode UI with pulsing neon accents (
#ff2020), dynamic glowing SVG geometry, and continuous background animations that react to user engagement. - Custom Hardware Cursor: A bespoke, see-through cursor implemented with precision CSS blend modes (
mix-blend-mode: difference) to ensure it never obscures critical text while maintaining a high-tech feel. - Persistent Data Store: A robust SQLite backend handling data transactions and state persistence seamlessly across user sessions.
- Dynamic Loading Sequences: Custom
Loadercomponents that mimic authentic terminal cold-boot sequences, setting the tone before the main interface is revealed. - Responsive & Accessible Design: Engineered to provide a flawless, high-performance experience across both desktop and mobile platforms.
This project is built using a modern, performance-focused stack tailored for the React ecosystem:
- Next.js (v16.1.6): Utilizing the App Router paradigm for robust server-side rendering, routing, and API handling.
- React & React DOM (v19.2.3): The foundational library for building our component-driven user interface.
- better-sqlite3 (v12.8.0): A high-performance, synchronous SQLite3 wrapper for Node.js. It powers our fast, localized database operations (
data.db) directly on the server without the overhead of an external database connection.
- Vanilla CSS3 (Global & Modules): Extensive use of custom CSS properties (
var(--font-mono)), advanced animations (@keyframes), and structural layouts (flexbox,grid) to achieve our bespoke cyberpunk design without relying on heavy UI frameworks. - next/font/google: Automatic font optimization and loading for our custom stack:
DM Mono: For technical phrasing and terminal outputs.Inter: For highly legible, primary sans-serif content.VT323: For retro, pixel-art aesthetic headers and stylistic terminal inputs.
- Netlify Plugin for Next.js (v5.15.9): Ensures seamless deployment and optimal caching behavior on the Netlify edge network.
- ESLint (v9) & eslint-config-next: Strict code linting and standard enforcement to maintain a clean and secure codebase.
- Yarn/npm: Package management.
Follow these instructions to set up a local development environment.
Ensure you have Node.js (v18 or higher recommended) installed on your system.
Clone the repository and install the required npm packages:
git clone https://github.com/your-org/redteamx_website.git
cd redteamx_website
npm installCreate a local environment file by copying the provided example:
cp .env.example .env.local(Populate .env.local with any necessary development credentials.)
Start Next.js in development mode:
npm run devNavigate to http://localhost:3000 in your browser. The application supports Hot Module Replacement (HMR) and will auto-update as you edit files in the src/ directory.
redteamx_website/
├── src/
│ ├── app/ # Next.js App Router (page.js, layout.js)
│ ├── components/ # Reusable UI components (Terminal, Navbar, Loader)
│ └── globals.css # Core stylesheets and CSS variables
├── public/ # Static assets (images, raw SVGs)
├── .env.example # Environment variable template
├── data.db # Local SQLite database file
├── next.config.mjs # Next.js configuration and environment setup
└── package.json # Project dependencies and npm scripts
As a cybersecurity collective, we take secure coding rigorously. Our entire architecture is structured to eliminate common vulnerabilities natively:
- SQL Injection Prevention: All database interactions utilize strictly parameterized statements, entirely mitigating any SQL injection vectors.
- Cross-Site Scripting (XSS) Proofing: We leverage React's automatic data-escaping paradigms. All potentially untrusted user inputs (like Terminal cache renders) are treated exclusively as string literals, rendering XSS payloads inert.
- Secure API Authentication: Privileged endpoints (like the
addinfopostboard) validate interactions robustly against secure, server-side environment variables, preventing insecure direct object references and forged requests (CSRF).
Vulnerability Reporting: If you discover a vulnerability in our application, please report it to our team immediately through our designated contact channels. Please do not test active exploits against our production environment.
We encourage contributions from redteamX members and the broader open-source community!
- Fork the repository.
- Create your feature branch (
git checkout -b feature/NewModule). - Commit your changes (
git commit -m 'Add NewModule logic'). - Push to the branch (
git push origin feature/NewModule). - Open a Pull Request detailing your enhancements.
Designed and developed by the redteamX