Bildarchiv Bühler

The repository contains the source code and data of a web app embedded on the DFK Paris website (Bildarchiv Heinz-Peter Bühler). The web app is based on the DFK frontend library.

The app allows the user to search for analog archival material and prepare an order.

Data

All data relevant for the app is contained within the data/ directory. With the npm run import task, it is transformed to JSON for direct consumption by the app.

Development

The application consists of a small ruby data munger script a frontend to be embedded in virtually any website (static, cms, groupware etc.). Below, we provide basic instructions on how to get a development environment up and running.

Requirements

More recent versions will likely also work, here is what we used during development

ruby 3.0
nodejs v16.19

Setup

Install required libraries

bundle install
npm install

Once this is done, start the frontend development server with

npm run dev

so that the frontend is available at http://127.0.0.1:4000.

Production

To run the application in production, run

npm run build

and then upload the contents of the public/ directory to a web server of your choice. Make sure the web server sends the Access-Control-Allow-Origin: * header so that other pages can load the application code and data.

Once that is done, you can integrate the app into your website. Let's say you deployed it to https://myapp.example.com, then add the following snippets to your page:

<!DOCTYPE html>
<html>
  <head>
    ...
  </head>
  <body>
    ...
    <div is="app"></div>
    ...
    <script src="https://myapp.example.com/app.js"></script>
  </body>
</html>