Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Stivenz3/Nexu/llms.txt

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

Nexu is a web-based certification platform for Buenas Prácticas de Manufactura (BPM) — Colombia’s food safety standard under Resolución 2674 de 2013. Food handlers complete structured lessons (video, theory, mini-game, and exam blocks), earn a digital certificate upon passing all modules, and share a publicly verifiable QR link — all without installing anything.

Introduction

Learn what Nexu is, how it works, and the technology stack behind the platform.

Quickstart

Clone the repo, configure environment variables, and run the app locally in minutes.

Architecture Overview

Understand the React + Firebase architecture, app routes, and data flow.

Adding a Lesson

Step-by-step guide to creating and seeding a new BPM lesson into Firestore.

Certificates

How course certificates are issued, downloaded as PDF, and verified publicly via QR.

Deployment

Deploy the frontend to Vercel and keep Firebase rules and indexes up to date.

How Nexu Works

1

Register and log in

Users create an account with email and password (Firebase Auth). reCAPTCHA is verified server-side via a Vercel API endpoint.
2

Complete lessons in sequence

Each lesson contains ordered blocks — video, theory with inline questions, a mini-game, and a final exam. Blocks unlock sequentially as the previous one is completed.
3

Pass the final exam

Scoring 70% or higher on a lesson’s exam marks it as passed and advances the user to the next lesson in the learning path.
4

Earn a verifiable certificate

After completing all 8 lessons, the platform automatically issues a course certificate stored in Firestore. The certificate can be downloaded as a PDF and verified publicly via a QR code — no login required.
Lesson 1 (Higiene Personal) is already seeded in the shared Firebase project nexu-156ce. You can register and test the full lesson flow without running any seed commands.

Build docs developers (and LLMs) love