https://github.com/percolate/crostini
A demonstration app for the Percolate Developer Platform (PDP) written in Typescript
https://github.com/percolate/crostini
Last synced: about 1 year ago
JSON representation
A demonstration app for the Percolate Developer Platform (PDP) written in Typescript
- Host: GitHub
- URL: https://github.com/percolate/crostini
- Owner: percolate
- Created: 2019-02-05T23:58:00.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-07-12T03:34:14.000Z (about 3 years ago)
- Last Synced: 2025-05-13T17:21:47.925Z (about 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 264 KB
- Stars: 0
- Watchers: 30
- Forks: 2
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Crostini
An app for demonstrating functionality of the Percolate Developer Platform, written in
Typescript using Express.
Defines a manifest and [a Heroku app](https://prclt-crostini.herokuapp.com/). The
manifest defines both lifecycle callback and UI extension URLs, which are served by
the Heroku app.
For a similar app written in Python, see
[Biscotti.](https://github.com/percolate/biscotti)
## Running the app locally
To create an application server running on your own machine instead of Heroku, use the
following guide.
### Run the server
1. Install dependencies: `npm install`
1. Run the app: `npm start`
1. Verify it's working by navigating to [http://localhost:3000](http://localhost:3000),
you should see the string `hi`
### Expose the app publicly with ngrok
1. Install [ngrok](https://ngrok.com/)
1. Expose the running local server publicly: `ngrok http 3000`
1. Change the URL domains in the manifest to use the URL displayed by the `ngrok`
command. If you see the line `Forwarding https://490d31a3.ngrok.io ->
http://localhost:3000`, this means that the `prclt-crostini.herokuapp.com` domains
should be changed to `490d31a3.ngrok.io`
1. Upload the modified app manifest in the "App registration" page
1. Install the app in the "Manage apps" page
1. Verify that your local app received callback request to `/install` in the server logs
### Update the app secret
1. Stop the app if it is running
1. Navigate to the app details by clicking on the app in the "App registration" page
1. Click the "Show app secret" button to view the secret
1. Start the app back up with the `APP_SECRET` environment variable set to the value
shown, an example of this command:
```
APP_SECRET=c12de0430670c1e251e0502aa3afb385374df5337bdd20b27b0e77fc702c9b1a \
npm start
```
1. Navigate to a page with a UI component served by the app and verify that the JWT
payload is properly decoded - you should see a JSON payload under the "decoded"
header