[RERO ILS UI][1]

July 29, 2026 · View on GitHub

Public search:

Professional interface (admin):

Shared:

Introduction

Rero-ils-ui is a part of RERO ILS.

It's a Web UI (User Interface) of rero-ils for libraries management.

This interface aims to be simple and clear. It's made with Angular 21.

Requirements

Node.js 24
Angular 21
pnpm 11 (managed via Corepack, see packageManager in package.json)
rero-ils installed and running

Optionally, for development purposes, you can install an IDE such as Visual Studio Code, WebStorm, etc.

Quick start

After having launched RERO-ILS server:

# Install Node.js 24 (nvm is recommended: https://github.com/nvm-sh/nvm)
$ nvm install 24

# Enable Corepack (ships with Node.js, manages the pnpm version pinned in package.json)
$ corepack enable

# Get RERO-ILS-UI
$ git clone https://github.com/rero/rero-ils-ui.git
$ cd rero-ils-ui

# Project dependencies (also cleans an existing node_modules)
$ pnpm ci

# Build the shared library in watch mode (required, other projects depend on it)
# Keep this running in a separate terminal so changes rebuild automatically
$ pnpm exec ng build shared --watch

# Launch a local server using a proxy for https://localhost:5000 (rero-ils server)
$ pnpm run start-admin-proxy

Run the rero-ils dev server on https://localhost:5000 and run one of the pnpm run start-*-proxy scripts (see .ai/dev-commands.md) for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Production mode

To build all applications in production, just do:

pnpm run build

It generates all needed files in the dist directory.

Running unit tests

All projects use Vitest (@angular/build:unit-test).

Run all tests:

pnpm test

Run tests for a specific project:

pnpm exec ng test [project_name]

where project_name is one of:

admin
public-search
public-patron-profile
public-holdings-items
search-bar
shared

Further help

To get more help on the Angular CLI use pnpm exec ng help or go check out the Angular CLI README.

Translations

Commands:

pnpm run admin_extract_messages: will extract all strings in admin project and put them in en_US.json file (source file)
pnpm run admin_update_catalog: will extract all string in source file and put them into de/en/fr/it json files for translation
pnpm run public-search_extract_messages: same as admin, but for public-search project
pnpm run public-search_update_catalog: same as admin, but for public-search project
pnpm run extract_messages: launches extract-messages commands for all projects
pnpm run update_catalog: launches update-catalog commands for all projects