EducaPerú follows the standard Laravel 12 setup flow and ships with a convenienceDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/AlexQuintana147/EducaPeru/llms.txt
Use this file to discover all available pages before exploring further.
composer setup script that condenses the entire bootstrapping process into a single command. If you prefer full control over each step, a manual path is also documented below. Either way, you will be running the application locally in under five minutes.
Before you begin, make sure all server requirements are met.
Run the setup script
EducaPerú provides a single Composer script that handles the entire bootstrap sequence in one command.This script executes the following steps in order:
composer install— Downloads and installs all PHP dependencies fromcomposer.lock.- Copy
.env.example→.env— Creates your local environment file if it does not already exist. php artisan key:generate— Generates a unique 32-character application encryption key and writes it toAPP_KEYin.env.php artisan migrate --force— Runs all pending database migrations against the configured database (SQLite by default).npm install— Installs all Node.js frontend dependencies frompackage-lock.json.npm run build— Compiles and fingerprints CSS and JavaScript assets for production via Vite.
OR — Manual setup
If you need granular control over each step (for example, to skip migrations or use a different database before migrating), you can run the commands individually instead of using This is equivalent to what the
composer setup.composer setup script does, but lets you pause, inspect, and adjust between steps.Configure your environment
Open the
.env file in your editor and adjust the key variables for your local setup:APP_URL— Set to the URL your app will be served on (e.g.http://localhost:8000).- Database credentials — Only needed if you are switching away from the default SQLite driver.
- Mail settings — Update
MAIL_MAILER,MAIL_HOST, and related values to use a real mailer instead of the defaultlogdriver.
Start the development server
Start all development processes simultaneously with a single command:This launches four concurrent processes:
| Process | Command | Purpose |
|---|---|---|
| server | php artisan serve | PHP built-in web server at http://localhost:8000 |
| queue | php artisan queue:listen --tries=1 --timeout=0 | Processes queued jobs in real time |
| logs | php artisan pail --timeout=0 | Streams Laravel application logs to your terminal |
| vite | npm run dev | Vite HMR dev server for instant CSS/JS updates |
composer dev uses npx concurrently under the hood, so Node.js must be installed and available in your PATH. If Node.js is missing, the command will fail before the PHP server even starts.Visit the application
Open your browser and navigate to:You should see the EducaPerú home page served by Laravel. If the page does not load, check the terminal output from
composer dev for error messages from any of the four processes.Run the test suite
EducaPerú ships with a This script runs the following commands in sequence:
composer test script that clears the config cache before running PHPUnit, ensuring tests always execute against a clean state.php artisan config:clear— Flushes any cached configuration to prevent stale values from affecting test results.php artisan test— Executes the full PHPUnit test suite defined inphpunit.xml.
Tests use the environment defined in your
.env file by default. Consider creating a .env.testing file to point tests at a dedicated SQLite in-memory database so they never touch your development data.