Concepts

This section explains the core concepts and architectural patterns used throughout LightNap. Understanding these concepts will help you work more effectively with the framework and make informed decisions when extending it.

Architecture & Design

Solution & Project Structure

Understand how LightNap is organized, including the .NET backend projects, Angular frontend structure, and the data flow pattern that connects them. This is the foundation for understanding how all the pieces fit together.

API Response Model

Learn about LightNap’s standardized REST API response format, including how errors are handled, HTTP status codes are used, and how the frontend automatically processes API responses.

Core Features

Content Management System

Explore LightNap’s built-in CMS that enables administrators and content editors to create, manage, and publish multilingual static content. Learn about pages, zones, access control, and frontend integration.

Learn about LightNap’s breadcrumb navigation system that automatically generates navigation trails based on route configuration, supporting both static labels and dynamic content from route parameters.

Authentication & Security

Authentication & Tokens

Deep dive into LightNap’s JWT-based authentication system, including how access tokens and refresh tokens work, token lifecycle management, and integration with the Angular frontend.

Devices

Understand the device/session management system that allows users to track and manage their logged-in sessions across different browsers and devices.

Getting Started

New to LightNap? Start with:

  1. Solution & Project Structure - Get oriented with the codebase
  2. Authentication & Tokens - Understand the security model
  3. API Response Model - Learn the API patterns

Then explore the Common Scenarios section for practical implementation guides.

Table of contents