UI Development Kit - README

A desktop application starter to build on IdentityNow
Report Bug · Request Feature

• About the project
  • SvelteKit
  • Electron
• Using the starter
  • Installing Dependencies
  • Local Development
  • Build the application from source
• Contribute
• License
• Discuss

About the project

This Electron IdentityNow starter is a template for a desktop application you can use build out GUI applications that integrate with IdentityNow.

(back to top)

SvelteKit

SvelteKit is a framework that allows easy development of applications utilizing both frontend and backend components and modern security standards, and when you are ready to build it allows you to compile your code into numerous different deployment methods using different adapters (static html, node server, edge or lambda functions).
SvelteKit can be explored more here.

If you use this starter to build on top of, you will get a number of things implemented right out of the box:

• an OAuth Flow
• the SailPoint SDK
• a Desktop build of your app
• TypeScript
• SvelteKit
• TailwindCSS

(back to top)

Electron

Electron is a framework that allows you to build cross-platform desktop applications using web technologies. It combines the Chromium rendering engine and the Node.js runtime to allow you to build applications that can run on Windows, Mac, and Linux.

Inside the projects src folder there are two additional folders main and preload, these folders contain the code relevant to the electron portion of the application, this is where you determine the window theme, size, shape, and behavior as well as the startup logic for the application.

(back to top)

Using the starter

To use this starter application you will need NPM installed. You can find instructions on how to install NPM here.

Once you have NPM installed, you can clone this repository and run the below commands depending on your package manager of choice.

Installing Dependencies

To install the dependencies, run install using your package manager of choice.

# Using NPM
npm install

# Using Yarn
yarn install

# Using PNPM
pnpm install

(back to top)

Local Development

To start the application in development mode, first install dependencies, then run the dev script using your package manager of choice.

# Using NPM
npm run dev

# Using Yarn
yarn dev

# Using PNPM
pnpm dev

(back to top)

Build the application from source

To build the application from source, first install dependencies, then run the build script matching your OS platform, using your package manager of choice.

Command	Description	OS
build:win	Builds the application for Windows	Windows
build:mac	Builds the application for MacOS	MacOS
build:linux	Builds the application for Linux	Linux

# Using NPM
npm run build:win

# Using Yarn
yarn build:mac

# Using PNPM
pnpm build:linux

(back to top)

Contribute

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion to improve this project, please fork the repo and create a pull request. You can also make a suggestion by opening an issue with the tag enhancement. Don't forget to give the project a star! Thanks again!

Follow these steps to make contributions:

1. Fork the project.
2. Create your feature branch: git checkout -b feature/AmazingFeature
3. Commit your changes: git commit -m 'Add some AmazingFeature'
4. Push to the branch: git push origin feature/AmazingFeature
5. Open a pull request.

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Discuss

You can go to the SailPoint Developer Community Forum to discuss this tool with other users!

(back to top)