Skip to main content
Get the portfolio up and running on your local development environment.

​
Prerequisites

Before you begin, ensure you have the following installed:
  • Node.js: Version 20 or higher (this project uses Node.js 20 in CI/CD)
  • Package Manager: npm (comes with Node.js), yarn, or pnpm
Check your Node.js version: 
node --version

​
Installation Steps

1

Clone the repository

Clone the portfolio repository to your local machine:
git clone https://github.com/juanroccia/juanroccia.github.io.git
cd juanroccia.github.io
2

Install dependencies

Install the project dependencies using your preferred package manager:
npm install
The project uses the following main dependency:
  • astro: ^5.11.1 - The Astro framework powering the portfolio
3

Start the development server

Run the development server:
npm run dev
The development server will start at http://localhost:4321 by default.

​
Available Commands

All commands are run from the root of the project:
CommandAction
npm run dev or npm startStarts local dev server at localhost:4321
npm run buildBuild your production site to ./dist/
npm run previewPreview your build locally, before deploying
npm run astroRun CLI commands like astro add, astro check
npm run astro -- --helpGet help using the Astro CLI

​
Verify Installation

Once the development server is running, open your browser and navigate to http://localhost:4321. You should see the portfolio homepage.

​
Troubleshooting

If port 4321 is already in use, Astro will automatically try the next available port. Check the terminal output for the actual URL.
Ensure you’re using Node.js 20 or higher. You can use nvm to manage multiple Node.js versions:
nvm install 20
nvm use 20
Try clearing your package manager cache:
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

​
Next Steps

Build docs developers (and LLMs) love

Get started for freeTalk to us