You can have Mi App Números running in your browser in under two minutes. All you need to do is clone the repository, install the dependencies, and fire up the Vite development server — no extra configuration required.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jonathino2590/mi-app-numeros/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before you begin, make sure you have the following installed:- Node.js 18 or higher — Vite 8 requires at least Node.js 18.
- A package manager — npm (bundled with Node.js), yarn, or pnpm all work.
Steps
Install dependencies
Install all required packages. Choose the command that matches your preferred package manager:This will pull in React 19, Framer Motion, Lucide React, Tailwind CSS, and all other dependencies listed in
package.json.Start the dev server
Launch the Vite development server with hot-module replacement enabled:Vite will start on
http://localhost:5173 by default. The terminal will print the exact local URL once the server is ready.Open the app
Navigate to http://localhost:5173/mi-app-numeros/ in your browser.You will be greeted by the main menu — ¡Aprendamos los Números! — where you can choose between Paso a Paso (sequential learning) and Modo Aleatorio (random mode), or jump straight into Practice or Writing from inside any Learn card.
The
base path is set to /mi-app-numeros/ in vite.config.js, so the local URL includes that sub-path to match the GitHub Pages deployment.Available scripts
All scripts are defined inpackage.json and can be run with npm run <script>, yarn <script>, or pnpm <script>:
| Script | Command | Description |
|---|---|---|
dev | vite | Starts the local development server at http://localhost:5173 with hot-module replacement. |
build | vite build | Compiles and bundles the app into the dist/ directory, ready for production deployment. |
lint | eslint . | Runs ESLint across the entire project to catch code-quality issues and enforce React Hooks rules. |
preview | vite preview | Serves the production build from dist/ locally so you can verify the output before deploying. |
predeploy | npm run build | Automatically runs build before every deploy call. You do not need to invoke this script manually. |
deploy | gh-pages -d dist | Publishes the dist/ folder to the gh-pages branch, making the app live on GitHub Pages. Triggers predeploy first. |