PakAG Engineering Documentation

Welcome to the technical handbook for PakAG, the package distribution and tracking platform in this monorepo.

[!NOTE] This documentation is generated from the actual repository structure under backend-js and frontend-app and is intended for onboarding new developers quickly.

What you will find here

  • Complete architecture and codebase orientation.
  • Verified backend and frontend implementation patterns.
  • API and authentication flows.
  • Environment, deployment, troubleshooting, and contribution workflows.
  • AI collaboration rules for docs maintenance.

Quick path

If you are…Start hereThen read
New to the projectProject OverviewMonorepo Structure
Setting up locallyLocal SetupBackend or frontend docs for your area
Changing an API flowAPI ReferenceBackend Documentation
Working on UI behaviorFrontend DocumentationRelated API endpoint docs

Maintenance checklist

Before publishing documentation changes, confirm:

  • The same content exists in English, Spanish, and Basque.
  • Links match the current route structure.
  • Code, API names, and folder paths match the repository.
  • New sections stay short, scannable, and useful for onboarding.
  • Diagrams are preserved or updated in all affected locales.

High-level system diagram