AegisPass - Node.js Authentication Boilerplate

🚀 The Ultimate Node.js & MongoDB Auth Backend. Build Faster!

Stop wasting weeks writing repetitive authentication logic, configuring database schemas, and battling with environment variables. AegisPass is an enterprise-grade, production-ready backend boilerplate designed to get your next SaaS, web app, or mobile API off the ground in literal seconds.

🔥 LIVE DEMO

Experience the power of AegisPass firsthand: URL: https://aegispass.irisoft.net Email: test@irisoft.net Password: demo1234

⚡ The Magic of "Zero-Touch" Installation

AegisPass introduces a revolutionary Automated Installer. Forget complex setup manuals. Just extract the files, run npm install, and watch as the system autonomously resolves dependencies, generates cryptographic keys, connects to your database, and builds your schemas. It is absolute plug-and-play magic!

🛡️ Next-Generation Security & Features

Give your users the frictionless, modern login experience they deserve while keeping your application locked down with bulletproof security:

• Passwordless Magic Code: Allow users to log in securely with a One-Time Password (OTP) sent directly to their inbox.
• Two-Factor Authentication (2FA): Provide bank-level security with TOTP authenticator app integration.
• Social Logins: 1-Click login and registration via Google and GitHub.
• Stateless JWT: Highly scalable, secure JSON Web Token session management.

💻 Frontend & Backend Flexibility

Whether you want to use the deeply integrated, beautifully responsive EJS views right out of the box, or connect your own React, Vue, or Flutter application via our comprehensive RESTful API, AegisPass adapts to your workflow seamlessly. The code is impeccably clean, heavily commented, and follows strict MVC architecture.

Don't reinvent the wheel. Accelerate your development, secure your user data, and launch your project today with AegisPass!

Features

• 🚀 Zero-Touch Auto-Installer: Completely automated setup. No .env configuration or manual DB schema creation!
• 🔑 Magic Code Login: Highly secure, passwordless OTP authentication via email.
• 📱 Two-Factor Authentication (2FA): Time-based OTP (TOTP) support for maximum account security.
• 🌐 Social OAuth Integrations: 1-click seamless logins with Google and GitHub.
• ✉️ Email Verification System: Automated account activation links to guarantee a valid user base.
• 🔐 Advanced Cryptography: Passwords are mathematically hashed and salted using bcrypt.
• 🎫 JWT Session Management: Stateless, scalable, and highly secure token-based authorization.
• 🗄️ MongoDB Architecture: Powered by Mongoose ODM with pre-configured validation schemas.
• 🎨 Ready-to-Use UI: Clean, responsive frontend views rendered dynamically with EJS.
• 🔌 Developer-Friendly REST API: Easily connect any mobile app or modern JS framework.
• Clean Clean MVC Codebase: Strictly adheres to modern JavaScript (ES6+) design patterns.

Requirements

• Node.js: Version 16.x or higher is recommended.
• Database: MongoDB (A local installation or a MongoDB Atlas cluster URI).
• Terminal: Basic knowledge of command-line tools to run NPM commands.
• SMTP Server (Optional): Required for sending Magic Codes and Email Verification links (e.g., Gmail, SendGrid, Mailgun).

Instructions

1. Extract: Unzip the downloaded AegisPass file into your desired project folder.
2. Navigate: Open your terminal or command prompt and navigate to the extracted directory.
3. Install (The Magic Step): Run npm install. Sit back as the AegisPass Auto-Installer takes over, resolves all dependencies, and completely prepares your environment variables and database securely.
4. Launch: Run npm start to fire up your server.
5. Access: Open your web browser and go to http://localhost:3000 to see your fully functioning authentication system live!