@sfdocs-internal/portal NPM

@salesforcedocs/portal

Base Package to define a portal that aggregates Writer Asset Repositories into a Site.

While Writer Asset Repositories can also be standalone sites, they are not capable of orchestrating several repositories into a portal.

Portal Start

When the portal starts, these tasks are performed:

Read the configuration of the site
Resolve the list of doc repositories ( writer asset repos ), through fetching or linking
Dynamically generate routes for repo content
Start the LWR server

Portal Local Repository Linking

The portal has the ability to 'link' an external repository URL with a repository folder on the local file system, which would then configure the build step to read from the local repository folder and not be downloaded from the given github URL. This 'link' step would need to be run before calling portal.start().

This is done by performing the linking cli command for each local repository prior to starting the portal.

For example, to link the github repo https://github.com/salesforcedocs/example to a local clone of the repository under /home/user/example, run:

sfdocs portal . --link-repo=https://github.com/salesforcedocs/example --link-dir=/home/user/example

Github Authentication

Access to private writer asset repositories in Github is done using Github Apps authentication.

Credentials may be supplied on the local development environment as files under the credentials folder or through environement variables.

Local dev

When developing locally, you'll want the build to use the certificates directory on the file system vs the environment variables. If you do not have the environment variables GITHUB_APP_ID and GITHUB_CERTIFICATE_PATH specified then it'll use the local file system directory specified in the configuration.certificatesDir property. Alternatively, you could specify LOCAL_DEV=1 as an environment variable to toggle local mode.

config.certificatesDir - The location of certificates on the local file system to use for authentication. Used only when specfied for running local development.

To setup credential files for local development check out this readme

Supply credentials through ENV

Supply these environment variables when running the app:

GITHUB_APP_ID=<ID of your Github App>
GITHUB_CERTIFICATE_BASE64=<Certificate plaintext encoded in base64>

You may also create a .env file with these variables and specifying the env file in a VSCode VSCode launch command:

{
    "configurations": [
        ...
        {
            ...
            "type": "node",
            "envFile": "${workspaceFolder}/.env"
        }
    ]
}

@octokit/rest @sfdocs-internal/doc-framework @sfdocs-internal/logger @sfdocs-internal/types aws-sdk base-64 cosmiconfig expand-tilde fs-extra https-proxy-agent jsonwebtoken lru-cache simple-git

@infinitebrahmanuniverse/nolb-_sf @everything-registry/sub-chunk-826

24 days ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

0.6.91-lwc-node-update1

4 months ago

0.6.91-test

4 months ago

0.6.91-test2

4 months ago

0.6.90-guides-title-alpha

4 months ago

0.6.90-coveosearch1-alpha

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

0.6.86-ssg-sitemap-alpha

9 months ago

9 months ago

6 months ago

8 months ago

9 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

7 months ago

0.6.89-tab-grid-alpha2

7 months ago

0.6.89-tab-grid-alpha1

7 months ago

10 months ago

10 months ago

10 months ago

8 months ago

8 months ago

11 months ago

11 months ago

8 months ago

8 months ago

11 months ago

10 months ago

10 months ago

10 months ago

8 months ago

8 months ago

5 months ago

9 months ago

9 months ago

9 months ago

10 months ago

7 months ago

9 months ago

9 months ago

8 months ago

7 months ago

6 months ago

7 months ago

7 months ago

7 months ago

7 months ago

9 months ago

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

9 months ago

10 months ago

8 months ago

7 months ago

0.6.89-guide-custom-layout-1

7 months ago

7 months ago

11 months ago

11 months ago

10 months ago

0.6.90-multiple-image-classes-1

6 months ago

0.6.85-global-nav-alpha

11 months ago

9 months ago

9 months ago

7 months ago

11 months ago

0.6.86-supportedLocales3

10 months ago

11 months ago

11 months ago

9 months ago

11 months ago

6 months ago

6 months ago

6 months ago

7 months ago

10 months ago

10 months ago

10 months ago

10 months ago

5 months ago

7 months ago

5 months ago

5 months ago

5 months ago

5 months ago

0.6.90-grid-with-custom-images

6 months ago

11 months ago

11 months ago

11 months ago

11 months ago

0.6.86-ssg-content-repo-alpha

12 months ago

0.6.86-validate-preview-1

11 months ago

0.6.85-image-resize-1

1 year ago

0.6.85-ssg-preview-alpha

11 months ago

0.6.84-ssg-preview-alpha

12 months ago

0.6.85-releasePhase

11 months ago

0.6.85-validate-diff-2

11 months ago

0.6.85-validate-diff

11 months ago

0.6.87-ssg-content-repo-alpha

12 months ago

0.6.85

11 months ago

0.6.85-link-alpha

11 months ago

0.6.85-invalid-toc-attributes

11 months ago

0.6.85-ssg-uniqueid-alpha

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

0.6.85-ssg-content-repo-alpha

12 months ago

11 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.6.83-alpha-npmpublish-3

1 year ago

0.6.83-alpha-npmpublish-2

1 year ago

0.6.83-alpha-npmpublish-4

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.6.83-nodeadurl-alpha

1 year ago

0.6.82-alpha4

1 year ago

0.6.82-alpha3

1 year ago

0.6.82-alpha1

1 year ago

0.6.84-h3-h4-linking-3

1 year ago

0.6.84-nodeadurl-alpha

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.6.80-ssgFilenameLen-alpha

1 year ago

0.6.78-alpha30

1 year ago

0.6.79-gha-alpha6

1 year ago

0.6.79-gha-alpha

1 year ago

0.6.78-markdown-table-lessthan

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.6.79-ssgFilename-alpha

1 year ago

0.6.81-alpha8

1 year ago

0.6.81-alpha9

1 year ago

0.6.81-updated-packages-1

1 year ago

0.6.81-updated-packages-2

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.6.78-include-fix-alpha1

1 year ago

0.6.78-ssg-alpha2

1 year ago

0.6.78-ssg-alpha1

1 year ago

0.6.78-toc

1 year ago

0.6.78-ymlLoader-alpha

1 year ago

0.6.44-example1

1 year ago

0.6.81-ssgFilenameLen-alpha

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1 year ago

2 years ago

2 years ago

0.6.76-reference-languages1

2 years ago

2 years ago

2 years ago

1 year ago

2 years ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

0.6.66-validation-log1

2 years ago

0.6.66-validation-log

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

0.6.61-prerender-remove

2 years ago

0.6.61-test-prerender2

2 years ago

0.6.62-iplugin

2 years ago

0.6.61-test-prerender1

2 years ago

0.6.61-test-prerender

2 years ago

0.6.58-lint

2 years ago

0.6.61-prerender-remove-2

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

0.6.52-heading-update

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago