Skip to main content

BookStack + Google Apps Script Integration Demo

Overview

This project will help you get familiar with our technical setup by integrating a Google Apps Script web app into our BookStack knowledge base. You will be working with Docker, Google Apps Script, and BookStack.

Objectives

  • Set up and run the BookStack app using Docker containers.
  • Create and deploy a "Hello World" Google Apps Script web app.
  • Embed the web app as an iframe in a BookStack page.
  • Record a short demo video to demonstrate the setup.

Prerequisites

Before starting, please review the following documentation to ensure a smooth setup:

Tasks

1. Set Up BookStack with Docker

  • Use the official BookStack Docker guide or our internal repository if available.
  • Ensure the BookStack app is accessible locally, e.g., http://localhost:8080.
  • Log in using the default or configured credentials.

Expected Outcome: BookStack app is running locally in Docker.

2. Create a Google Apps Script Web App

  1. Go to script.google.com.
  2. Create a new project and paste the following code:
function doGet() {
  return HtmlService.createHtmlOutput("<h1>Hello World</h1>");
}
  1. Deploy the script as a web app:
    • Click Deploy > New deployment.
    • Click Select type and choose Web app.
    • Enter a description, e.g., "Hello World Deployment".
    • Under Execute as, select Me.
    • Under Who has access, select Anyone.
    • Click Deploy.
    • Authorize the script if prompted.
    • Copy the deployment URL.

Expected Outcome: A public URL that displays "Hello World".

3. Embed the Web App in BookStack

  • Log in to your local BookStack instance.
  • Create a new Page or edit an existing one.
  • Use the following HTML to embed the web app:
<iframe src="YOUR_WEB_APP_URL_HERE" width="100%" height="500" style="border: none;"></iframe>

Expected Outcome: A page in BookStack that shows the embedded "Hello World" web app.

Final Deliverable

Please record a short demo video showing:

  • The BookStack app running in Docker.
  • The embedded "Hello World" app functioning in BookStack.
  • A brief explanation of your setup.

Upload the video to the following Google Drive folder:
Upload Link

Questions or Issues?

If you run into any problems or have questions, reach out to Thian-Peng directly on Signal.

Back to top