Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
timonback committed Apr 16, 2023
1 parent 54ff0ac commit 90e4beb
Show file tree
Hide file tree
Showing 4 changed files with 33 additions and 22 deletions.
14 changes: 8 additions & 6 deletions .github/workflows/build-and-deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ on:
push:
branches:
- main
workflow_dispatch: {}
workflow_dispatch:

permissions:
# Allow to publish github pages
Expand All @@ -28,11 +28,6 @@ jobs:

- name: Build
run: ./gradlew build
- name: Deploy to gh pages 🚀
if: github.ref == 'refs/heads/main'
uses: JamesIves/github-pages-deploy-action@v4
with:
folder: dist/

- name: Publish package
if: github.ref == 'refs/heads/main'
Expand All @@ -43,3 +38,10 @@ jobs:
ORG_GRADLE_PROJECT_MAVEN_USERNAME: ${{ secrets.GITHUB_USERNAME }}
ORG_GRADLE_PROJECT_MAVEN_PASSWORD: ${{ secrets.GITHUB_TOKEN }}

- name: Build pages
run: ./gradlew buildPages
- name: Deploy to gh pages 🚀
if: github.ref == 'refs/heads/main'
uses: JamesIves/github-pages-deploy-action@v4
with:
folder: dist/
5 changes: 4 additions & 1 deletion .github/workflows/publish-release.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
name: Publish release

on: workflow_dispatch
on:
push:
tags:
- '*'

permissions:
packages: write
Expand Down
35 changes: 21 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,42 @@
![version](https://img.shields.io/github/v/release/springwolf/springwolf-asyncapi-ui)
![springwolf-ui](https://github.com/timonback/springwolf-asyncapi-ui/workflows/build-and-deploy/badge.svg)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

# Springwolf AsyncApi UI
##### AsyncApi Web UI for Springwolf
##### Use Springwolf with the [AsyncApi Initiative UI](https://github.com/asyncapi/asyncapi-react)

Demo: https://demo-asyncapi-ui.springwolf.timonback.de
Demo: https://timonback.github.io/springwolf-asyncapi-ui/

:warning: This project is a proof of concept to use a different ui for [springwolf](https://github.com/springwolf/springwolf-core). At this point, I do not plan to maintain this actively. But feel free to leave a message in case you find it useful or you have suggestions.

## Usage
Add the following dependencies:
Refer to the [springwolf](https://github.com/springwolf/springwolf-core) project for the general setup.

Now, also add the following to your `build.gradle` file:

```groovy
repositories {
// ...
maven {
url "https://maven.pkg.github.com/timonback/springwolf-asyncapi-ui"
}
}
dependencies {
// One of the springwolf plugins is required to build the AsyncApi document (general setup)
implementation 'io.github.springwolf:springwolf-kafka:0.10.0'
// Add the ui of this project
runtimeOnly 'io.github.springwolf:springwolf-asyncapi-ui:0.1.0'
}
```

After starting the application, visit: `localhost:8080/springwolf/asyncapi-ui/index.html`.
After starting the spring application, visit: `localhost:8080/springwolf/asyncapi-ui/index.html`.

## Development
1. Run `npm run build_pages`
1. Run `npm run build_pages` (Uses asyncApi mock data)
2. Open `./dist/index.html` in your browser

## Release

Releasing is done by running the gradle task `publish`. For local development, use `publishToMavenLocal`.

### Setup the signing keys

If you do not have gpg keys yet, generate one with: `gpg --full-gen-key` You will need to set password.

Use the following environment variables:
- ORG_GRADLE_PROJECT_SIGNINGKEY: Output of `gpg --armor --export-secret-key`
- ORG_GRADLE_PROJECT_SIGNINGPASSWORD: Password for the gpg key
The maven package is available on github packages.
1 change: 0 additions & 1 deletion build.gradle
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
plugins {
id 'java'
id 'com.github.node-gradle.node' version '3.5.1'
id 'signing'
id 'maven-publish'
}

Expand Down

0 comments on commit 90e4beb

Please sign in to comment.