Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/EricMartinez758/corpointa-frontend/llms.txt

Use this file to discover all available pages before exploring further.

Corpointa is a modern, full-featured inventory management platform built for warehouse operators, stock controllers, and logistics teams. It provides a rich single-page application experience that communicates with a dedicated REST API backend to deliver real-time visibility over materials, stock levels, inbound entries, outbound dispatches, and a comprehensive audit trail — all from a single, responsive interface.

Tech Stack

Corpointa’s frontend is assembled from a carefully chosen set of production-grade libraries:
LayerTechnology
UI FrameworkReact 19
Build ToolVite 8
StylingTailwindCSS v4
RoutingTanStack Router (file-based, auto code-splitting)
Server StateTanStack Query v5
Component PrimitivesRadix UI / shadcn/ui
HTTP ClientAxios
Client StateZustand
Schema ValidationZod v4
Data TablesTanStack Table v8
ChartsRecharts
Auth (optional)Clerk React SDK

Feature Modules

Corpointa ships with the following application modules, accessible from the main sidebar:
  • Dashboard — High-level KPIs, recent activity, and analytics charts giving a snapshot of overall inventory health.
  • Existencias (Stock) — Live view of current stock levels across all materials and locations, with filtering and export.
  • Control Perceptivo (Entries) — Log and manage incoming material receipts. Tracks supplier, quantity, date, and responsible employee.
  • Despachos (Dispatches) — Record outbound movements from the warehouse. Links dispatches to destinations and employees.
  • Materials Catalog — Master list of all managed materials, including descriptions, units, and category assignments.
  • Categorías — Create and manage material categories used to classify the materials catalog.
  • Unidades de Medida — Define and maintain units of measurement applied to stock quantities.
  • Destinos — Manage destinations (delivery addresses / cost centers) referenced by dispatches.
  • Proveedores — Supplier directory used when registering incoming material entries.
  • Empleados — Employee records linked to entry and dispatch transactions for accountability.
  • Usuarios — User account management with role-based access control.
  • Bitácora (Audit Log) — Immutable, timestamped record of every create, update, and delete operation across the system.
  • Settings — Application-level preferences including appearance, font selection, and theme.

Authentication

Corpointa supports two authentication modes that can be selected at deployment time:
  1. Built-in JWT (default) — Users sign in with their cédula (national ID) and password. The backend issues a JWT that is stored in a browser cookie and automatically attached to every API request via an Axios request interceptor.
  2. Clerk (optional) — Routes under src/routes/clerk/ use the Clerk React SDK for managed authentication. This mode requires setting the VITE_CLERK_PUBLISHABLE_KEY environment variable.

License & Version

Corpointa frontend is released under the MIT License. The current stable release is v2.2.1.

Where to Go Next

Quickstart

Clone the repo, install dependencies, and have your dev server running in under 5 minutes.

Configuration

Learn how to configure environment variables, the API client, and authentication modes.

Dashboard

Explore the analytics dashboard and understand the data it surfaces.

API Overview

Understand the REST API contract that Corpointa’s frontend depends on.

Build docs developers (and LLMs) love