https://github.com/garronej/oidc-nexus
Booking the NPM name oidc-nexus
https://github.com/garronej/oidc-nexus
Last synced: 3 months ago
JSON representation
Booking the NPM name oidc-nexus
- Host: GitHub
- URL: https://github.com/garronej/oidc-nexus
- Owner: garronej
- License: mit
- Created: 2024-07-30T14:50:18.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-07-30T14:53:54.000Z (11 months ago)
- Last Synced: 2025-03-30T15:07:30.464Z (3 months ago)
- Language: TypeScript
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Booking the NPM name oidc-nexus
# Install / Import
```bash
$ npm install --save oidc-nexus
```
```typescript
import { myFunction, myObject, MyReactComponent } from "oidc-nexus";
```
Specific imports, only import what you need:
```typescript
import { myFunction } from "oidc-nexus/myFunction";
import { myObject } from "oidc-nexus/myObject";
import MyReactComponent from "oidc-nexus/MyReactComponent";
```
# Contributing
## Testing your changes in an external app
You have made some changes to the code and you want to test them
in your app before submitting a pull request?
Assuming `you/my-app` have `oidc-nexus` as a dependency.
```bash
cd ~/github
git clone https://github.com/you/my-app
cd my-app
yarn
cd ~/github
git clone https://github.com/garronej/oidc-nexus
cd oidc-nexus
yarn
yarn build
yarn link-in-app my-app
npx tsc -w
# Open another terminal
cd ~/github/my-app
rm -rf node_modules/.cache
yarn start # Or whatever my-app is using for starting the project
```
You don't have to use `~/github` as reference path. Just make sure `my-app` and `oidc-nexus`
are in the same directory.
> Note for the maintainer: You might run into issues if you do not list all your singleton dependencies in
> `src/link-in-app.js -> singletonDependencies`. A singleton dependency is a dependency that can
> only be present once in an App. Singleton dependencies are usually listed as peerDependencies example `react`, `@emotion/*`.
## Releasing
For releasing a new version on GitHub and NPM you don't need to create a tag.
Just update the `package.json` version number and push.
For publishing a release candidate update your `package.json` with `1.3.4-rc.0` (`.1`, `.2`, ...).
It also work if you do it from a branch that have an open PR on main.
> Make sure your have defined the `NPM_TOKEN` repository secret or NPM publishing will fail.