Welcome to the fabiencrassat's Curriculum Vitae source code - a development with the NuxtJs framework.

• Prerequisites
• Installation
• Structure
• Start like production
• Before commit
  • GitHub Workflow
• Code Analysis
  • HTML & A11Y validator
  • SonarQube
    • SonarQube Installation [Local Only]
    • SonarQube Usage [Local Only]
  • Google Chrome Lighthouse
    • Lighthouse Server [Local Only]
    • Lighthouse Usage [Local Only]
• SVG images
• License

• GIT
• NodeJS and NPM Version 20

Or

• GIT
• Podman

Clone the repository

git clone https://github.com/fabiencrassat/cv-with-nuxt.git

Then install the packages

cd cv-with-nuxt
yarn install --frozen-lockfile

# Or with Podman
podman run --interactive --name cv-with-nuxt-dev -p 3000:3000 --rm --tty --entrypoint /bin/sh --volume "$(pwd):/app" docker.io/node:20.16.0-alpine3.20
# After existing the container, the ports 8000 & 9000 are still in used "sudo netstat -tulpn" and need to be killed "kill -9 PID"
cd app
yarn install --frozen-lockfile

Run it!

# Start the development server on http://localhost:3000
yarn dev

Go to http://localhost:3000/fabien

The product source code is structured with:

  .
  ├── config          # Built and runtime configuration.
  ├── lib             # All codes used into the application but that **do not use nuxt and vue**.
  ├── scripts         # All files called in the `package.json` script section.
  └── src
      ├── assets      # All static files that need to be served without i18n.
      ├── components  # All codes imported in the `src/pages/` files, **using nuxt and vue**.
      ├── locales     # All i18n json files.
      ├── pages       # All the application pages called with URL, served with **nuxt** and **i18n**.
      ├── public      # All public files that can be link from the root website.
      └── resources   # All resources to build the curriculum vitae.

This site is a static website. So to replicate what is deployed on the website there are some things to do first.

# Build the application for production
yarn build
# Locally preview production build
yarn run preview

And open the page: http://localhost:3000/fabien

To ensure the GitHub CI CD pipeline will stay green, launch the following command before committing and have no error.

yarn lint & yarn test:coverage

In two shell windows:

1. Start like production

2. Run the validation

   yarn validate:pages

The source code of the pages from src/pages for each language is output in build/html-pages.

If there are some exceptions to exclude, add entries in config/validators.config.js.

If you want to know about your code analysis, you can use SonarQube for that. To do so:
Source: https://docs.sonarqube.org/display/SONAR/Get+Started+in+Two+Minutes

Do the SonarQube Installation before starting any developments in order to know how it will change the metrics.

Each time you want to know about your quality code, launch a scan with the following command in the root folder! And you will have your evolution ;)

# Start the server if needed
<SONARQUBE BIN PATH>\StartSonar.bat
# Create coverage reports
yarn test:coverage
# Launch the scan
<SONARQUBE SCANNER BIN PATH>\sonar-scanner.bat;

If you want to know about your code audit, you can use Google Chrome Lighthouse for that. To do so, use the docker image already published:
Source: https://github.com/GoogleChrome/lighthouse-ci/blob/master/docs/recipes/docker-server/README.md#building-locally

The docker command is wrong for Windows, use instead:

docker container run --publish 9001:9001 --mount source=lhci-data,target=/data --detach patrickhulce/lhci-server

It will create a container server you can access at http://localhost:9001/.

Then initialize the project inside the server:

yarn lhci wizard
? Which wizard do you want to run? new-project
? What is the URL of your LHCI server? http://localhost:9001/
? What would you like to name the project? cv-with-nuxt
? Where is the project's code hosted? https://github.com/fabiencrassat/cv-with-nuxt
? What branch is considered the repo's trunk or main branch? master
Created project cv-with-nuxt (9461df84-ee42-4868-9061-62a8391c7fec)!
Use token xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx to add data.
Use admin token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx to manage data. KEEP THIS SECRET!

Use the LHCI server URL and the token xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx in your .env file.

LHCI_SERVER_BASE_URL=http://localhost:9001
LHCI_TOKEN=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Do the Lighthouse Usage before starting any developments in order to know how it will change the metrics.

Each time you want to know about your audit code, launch an audit with the following command in the root folder! And you will have your evolution ;)

if needed, configure your CHROME_PATH in your .env file.

yarn generate
yarn start:static

And in another shell:

yarn validate:lighthouse

The SVG images library comes from http://www.entypo.com/

MIT