Getting Started

Welcome to the comprehensive technical documentation for Ashif's Developer Portfolio. This repository serves as the central hub detailing the architecture, implementation protocols, and operational guidelines for a diverse suite of production-grade open-source projects, spanning from highly interactive front-end applications to robust data-driven backends.

This documentation extensively covers the following flagship projects. Select a project below to delve into its specific features, tech stack, and API documentation:

Portfolio Strategy (React & Vite): A modern, performant personal developer portfolio complete with a secure administrative dashboard for dynamic content management.
Noirel Enterprise E-commerce: A high-end, full-stack e-commerce experience implementing secure cart logic, payment gateway integration, and a premium UI.
Salary Reality Engine: An AI-driven analytics platform providing market intelligence, percentile calculations, and machine-learning powered salary forecasts.
Time Lens Psychological Tool: A mathematically rigorous mindset application designed to reframe time perception and drive intentional user behavior.

Every project page is structured to provide an immediate high-level functional overview, followed by deep dives into the underlying technologies and specialized installation procedures.

🛠️ Global Prerequisites

Before attempting to execute any of the repositories within this portfolio locally, you must ensure your development environment is primed with the following foundational technologies:

Programming Runtimes

Node.js: Expected version v18.x Minimum (Current LTS recommended) for all Next.js, React, and Vite driven projects.
Python: Expected version v3.10 Minimum for the successful execution of Django server logic and FastAPI data pipelines.

Package & Environment Management

npm / yarn / pnpm: The Javascript ecosystem requires one of these standard package managers.
pip / venv: Standard Python library management and virtual environment creation tools.

Infrastructure & Operations

Docker & Docker Compose: Strictly required for containerized applications (like the Fullstack Blog) to guarantee environment parity and streamline multi-service orchestration.
Git: The universal standard for version control. Required to clone the repositories and manage branches effectively.

🚀 Next Steps

Review the Foundational Architecture principles governing these builds.
Read through our strictly enforced Development Conventions.
Proceed to the General Installation Overview to bootstrap your first local instance.