Skip to main content

Prerequisites

Before installing Paginator, ensure you have the following tools installed on your system:
Minimum version: 18.18.0 or higherDownload and install from nodejs.orgVerify installation:
node --version
Recommended version: 19.1.8 or higherInstall globally via npm:
npm install -g @angular/cli
Verify installation:
ng version
Required for cloning the repositoryDownload from git-scm.comVerify installation:
git --version

Installation Steps

Follow these steps to get Paginator running on your local machine:
1

Clone the Repository

Clone the Paginator repository from GitHub:
git clone https://github.com/AndresOrozcoDev/Paginator.git
cd Paginator
This will create a Paginator directory with all the source code.
2

Install Dependencies

Install all required npm packages:
npm install
This will install:
  • Angular 19.1.0 and related packages
  • Bootstrap 5.3.7
  • RxJS 7.8.0
  • TypeScript 5.7.2
  • Development dependencies (Karma, Jasmine, etc.)
The installation may take a few minutes depending on your internet connection.
3

Verify Installation

Verify that everything is installed correctly:
ng version
You should see output showing Angular CLI version 19.1.8 and Angular version 19.1.0.
4

Start Development Server

Start the Angular development server:
ng serve
Or use the npm script:
npm start
The application will be available at http://localhost:4200

Project Structure

After installation, you’ll find the following structure:
Paginator/
├── src/
│   ├── app/
│   │   ├── core/              # Core module (services, loading component)
│   │   │   ├── components/
│   │   │   └── services/      # ThemeService, LoadingService
│   │   ├── features/
│   │   │   └── paginator/     # Main feature module
│   │   │       ├── components/ # Filters, Table, Pagination, Header
│   │   │       ├── page/      # Home component
│   │   │       ├── services/  # LocationsService
│   │   │       └── types/     # TypeScript interfaces
│   │   ├── app.component.ts
│   │   └── app.routes.ts
│   ├── assets/
│   ├── styles.scss
│   └── index.html
├── angular.json
├── package.json
└── tsconfig.json

Available Scripts

Once installed, you can run these npm scripts:
npm start
# or
ng serve

Common Issues and Troubleshooting

If port 4200 is already in use, you can specify a different port:
ng serve --port 4300
Try clearing the npm cache and reinstalling:
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
Ensure you have the correct Angular CLI version installed:
npm uninstall -g @angular/cli
npm install -g @angular/[email protected]
Make sure you’re using TypeScript 5.7.2 as specified in package.json:
npm install [email protected] --save-dev
If you encounter persistent issues, try deleting node_modules and package-lock.json, then run npm install again.

Next Steps

Now that you have Paginator installed, check out the Quick Start guide to learn how to use the application and explore its features.

Build docs developers (and LLMs) love