Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Nettalco/nettalco-theme/llms.txt

Use this file to discover all available pages before exploring further.

Because @nettalco/nettalco-theme is published to GitHub Packages rather than the public npm registry, installation requires a brief authentication step before the familiar npm install command. This guide walks you through every step — from creating your .npmrc to importing the CSS needed to make PrimeNG components render correctly.

Requirements

Before you begin, make sure your project meets these prerequisites:
RequirementMinimum Version
Node.js18+
Angular21+
PrimeNG21+
@primeuix/themes2.0+
GitHub Personal Access Tokenwith read:packages scope
Don’t have a GitHub Personal Access Token yet? Head to GitHub → Settings → Developer Settings → Personal access tokens and create a fine-grained or classic token with at least the read:packages scope. See Authentication for full details.

Installation Steps

1
Authenticate with GitHub Packages
2
Create a .npmrc file in the root of your consuming project (not inside node_modules or any library folder). This file tells npm to route all @nettalco-scoped packages through the GitHub Packages registry.
3
# Route @nettalco packages to GitHub Packages
@nettalco:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
4
Never hard-code your token in .npmrc. Use the ${GITHUB_TOKEN} environment variable reference as shown above. If you commit a raw token, rotate it immediately on GitHub. Add .npmrc to .gitignore if your project-level file ever contains a literal token value.
5
Set the environment variable in your shell before running any npm commands:
6
# macOS / Linux
export GITHUB_TOKEN=ghp_YourTokenHere

# Windows PowerShell
$env:GITHUB_TOKEN = "ghp_YourTokenHere"

# Windows Command Prompt
set GITHUB_TOKEN=ghp_YourTokenHere
7
Install @nettalco/nettalco-theme
8
With authentication configured, install the package using your preferred package manager:
9
npm
npm install @nettalco/nettalco-theme
yarn
yarn add @nettalco/nettalco-theme
pnpm
pnpm add @nettalco/nettalco-theme
10
Install Peer Dependencies
11
If your project doesn’t already have PrimeNG and PrimeIcons installed, add them now:
12
npm
npm install primeng primeicons @primeuix/themes
yarn
yarn add primeng primeicons @primeuix/themes
pnpm
pnpm add primeng primeicons @primeuix/themes
13
@primeuix/themes is the package that provides the definePreset API and the Aura base that Nettalco Theme extends. It must be present at runtime.
14
Import PrimeNG Stylesheets
15
PrimeNG requires its base CSS and PrimeIcons to be loaded globally. Add these imports to your project’s entry point:
16
main.ts
import 'primeng/resources/primeng.css';
import 'primeicons/primeicons.css';
styles.scss
@import 'primeng/resources/primeng.css';
@import 'primeicons/primeicons.css';
17
If you’re using angular.json instead, add them to the styles array:
18
"styles": [
  "node_modules/primeng/resources/primeng.css",
  "node_modules/primeicons/primeicons.css",
  "src/styles.scss"
]

Verifying the Installation

After completing the steps above, check that the package appears in your node_modules:
ls node_modules/@nettalco/nettalco-theme
# Should show: package.json, fesm2022/, esm2022/, etc.
Or verify the installed version:
npm list @nettalco/nettalco-theme
# └── @nettalco/nettalco-theme@1.1.1

What’s Next

With the package installed, configure providePrimeNG to activate the preset:

Quickstart

Configure the theme provider and have styled components running in minutes.

Authentication Details

Learn more about GitHub Packages auth, CI/CD integration, and token scopes.

Build docs developers (and LLMs) love