Update publish.yml

Author: maxidragon

.github/workflows/deploy_docs.yml

@@ -0,0 +1,32 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [19.x]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+    - name: Install dependencies
+      run: yarn install
+      working-directory: ./docs
+    - name: Build
+      run: yarn build
+      working-directory: ./docs
+    - name: Deploy to GitHub Pages
+      uses: JamesIves/github-pages-deploy-action@v4.5.0
+      with:
+        branch: gh-pages
+        folder: ./docs/build

.github/workflows/publish.yml

@@ -1,7 +1,7 @@
 name: Publish to NPM
 on:
   release:
-    types: [created]
+    types: [published]
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -16,8 +16,17 @@ jobs:
           node-version: ${{ matrix.node-version }}
           registry-url: 'https://registry.npmjs.org'
       - name: Install dependencies and build
-        run: npm run prepublish
-      - name: Publish package
-        run: npm publish
+        run: yarn && yarn prepublish
+      - name: Extract tag version
+        id: extract_tag
+        run: echo ::set-output name=VERSION::${GITHUB_REF#refs/tags/v}
+      - name: Update version in package.json
+        run: |
+          npm --no-git-tag-version version ${{ steps.extract_tag.outputs.VERSION }}
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git config --global user.name "github-actions[bot]"
+          git commit -am "chore: bump version to ${{ steps.extract_tag.outputs.VERSION }}"
+      - name: Publish to npm
+        run: npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

README.md

@@ -12,7 +12,7 @@ This project is loosely based on [Vulcan API](https://github.com/kapi2289/vulcan
 
 ## Docs
 
-[Gitbook docs](https://capure.gitbook.io/vulcan-api-js/)
+You can find the docs [here](https://avorty.github.io/vulcan-api-js)
 
 ## License
 

docs/.gitignore

@@ -0,0 +1,23 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Other package managers
+pnpm-lock.yaml

docs/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ yarn
+```
+
+### Local Development
+
+```
+$ yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

docs/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

docs/docs/contributing/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Contributing",
+  "position": 5,
+  "link": {
+    "type": "generated-index",
+    "description": "Some details on how to contribute to the project."
+  }
+}

docs/docs/contributing/docs.md

@@ -0,0 +1,11 @@
+---
+sidebar_position: 3
+---
+
+# Contributing to the docs
+
+On every page you can find a link to the source file of the page. You can edit the file and create a pull request.
+
+## Docusaurus
+
+Our documentation uses Docusaurus. If you want to learn about Markdown or special features of Docusaurus you can look at the [Docusaurus documentation](https://docusaurus.io/docs). 

docs/docs/contributing/general.md

@@ -0,0 +1,17 @@
+---
+sidebar_position: 1
+---
+
+# General information
+
+Contributions are welcome! We are happy to accept contributions in the form of pull requests, issues, or just general feedback and discussion.
+
+## Contributing to the SDK
+
+See [Contributing to the SDK](./sdk).
+
+## Contributing to the documentation
+
+See [Contributing to the documentation](./docs).
+
+If you have any questions feel free to contact us.

docs/docs/contributing/sdk.md

@@ -0,0 +1,23 @@
+---
+sidebar_position: 2
+---
+
+# Contributing to the SDK
+
+You can look on the [list of issues](https://github.com/avorty/vulcan-api-js/issues) and pick one to work on. If you have an idea for a new feature, you can create an issue and discuss it with us.
+
+## Running SDK in the development mode
+
+We use yarn as a package manager.
+
+1. First install the dependencies
+
+```bash
+yarn install
+```
+
+2. Then run the SDK in development mode
+
+```bash
+yarn dev
+```