Installation
Install PDF Atelier from a private registry and configure your `.npmrc` securely.
Installing PDF Atelier from a private registry
Private registry (.npmrc) setup
Use the steps below to configure access to the private registry and safely store your access token (PAT).
- Create a
.npmrcfile in your project root (or update your user-level.npmrc) and add the private registry and authentication token entry exactly as shown:
@innosoft:registry=https://code.is.sa/api/v4/projects/871/packages/npm/
//code.is.sa/api/v4/projects/871/packages/npm/:_authToken=${PAT}-
Choose how to provide the token:
- For local development, export the token in your shell before running installs:
export PAT="your-token-here". - For CI, store
PATas a secret in your CI provider and make it available to the job environment — avoid hardcoding credentials in files.
- For local development, export the token in your shell before running installs:
-
Note:
yarnandpnpmrespect.npmrc, so the same file works across package managers.
Add your project's .npmrc to .gitignore to avoid committing a file that contains your access
token. In CI/CD, prefer using encrypted repository secrets or environment variables rather than
embedding tokens in files.
Framework-specific installation & quick start
- Install
npm install @innosoft/pdf-atelier-vanilla
# or
yarn add @innosoft/pdf-atelier-vanilla
# or
pnpm add @innosoft/pdf-atelier-vanilla- Quick start (vanilla web usage)
<!-- index.html -->
<script type="module">
import '@innosoft/pdf-atelier-vanilla';
</script>
<pdf-atelier src="/document.pdf" license="YOUR_LICENSE"></pdf-atelier>- Install
npm install @innosoft/pdf-atelier-react
# or
yarn add @innosoft/pdf-atelier-react
# or
pnpm add @innosoft/pdf-atelier-react- Quick start (React functional component)
import React from 'react';
import { PDFAtelier } from '@innosoft/pdf-atelier-react';
export default function App() {
return <PDFAtelier src="/document.pdf" license="YOUR_LICENSE" />;
}- Install
npm install @innosoft/pdf-atelier-vue
# or
yarn add @innosoft/pdf-atelier-vue
# or
pnpm add @innosoft/pdf-atelier-vue- Quick start (Vue 3 - Script Setup)
<script setup>
import PdfAtelierWrapper from '@innosoft/pdf-atelier-vue';
</script>
<template>
<PdfAtelierWrapper src="/document.pdf" :license="'YOUR_LICENSE'" />
</template>- Install
npm install @innosoft/pdf-atelier-angular
# or
yarn add @innosoft/pdf-atelier-angular
# or
pnpm add @innosoft/pdf-atelier-angular- Quick start (Angular)
// app.module.ts
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { PdfAtelierModule } from '@innosoft/pdf-atelier-angular';
@NgModule({
imports: [BrowserModule, PdfAtelierModule],
bootstrap: [AppComponent]
})
export class AppModule {}<!-- app.component.html -->
<pdf-atelier-wrapper [src]="'/document.pdf'" [license]="'YOUR_LICENSE'"></pdf-atelier-wrapper>Verify installation with
npm list @innosoft/<package-name> (replace <package-name> with the package for your framework). If you see the package listed, installation was successful.Tip: For production use, prefer CI-managed secrets and short-lived tokens. Rotate PATs regularly and audit access to private registries.