Centralized authentication and authorization service for the QuCore ecosystem. Provides SSO (Single Sign-On) and RBAC (Role-Based Access Control) across all corporate platforms.
- Runtime: Node.js 22+
- Frontend: Next.js 15 (TypeScript)
- Style: Tailwind CSS + SCSS (Strict Backticks, Zero Semicolons)
- State: Redux Toolkit
- Real-time: Socket.io-client
This module requires specific environment variables. Before running, ensure you have replaced these placeholders in your configuration
Create your configuration files and follow the internal instructions for BLOCK #1 (Local) and BLOCK #2 (Docker Overrides).
# Setup local environment
cp .env.example .env
# Setup production/docker environment
cp .env.example .env.prodUse this for standard development on your host machine.
# Install dependencies
npm install
# Run the Next.js development server
npm run devThe frontend supports containerized environments for consistent development and production parity.
# Run in development mode (with hot-reload)
docker-compose -f docker-compose.dev.yml up -d --build
# Run in production mode
docker-compose -f docker-compose.prod.yml up -d --buildA brief overview of the key directories in the QuCore Auth frontend:
src/app/: Next.js App Router (pages, layouts, and global assets).src/components/: Reusable UI atoms and larger functional widgets.src/i18n/&src/locales/: Internationalization configuration and translation files.src/store/: Redux Toolkit slices for global state management.src/services/: API clients and external communication logic (Axios, Sockets).
We follow the QuCore Elite standard:
- Linting: No semicolons, single quotes for logic, backticks for templates.
- Naming: PascalCase for components, camelCase for functions/files.
- Check: Always run
npm run lintbefore committing.
Created and maintained by Artem Zhytovoz. Distributed under the PolyForm Noncommercial 1.0.0 license.
Every line of code is a step toward global technological leverage.