The repository contains the source code and data of a web app embedded on the DFK Paris website (XXX). The web app is based on the DFK frontend library.
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.
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.
More recent versions will likely also work, here is what we used during development
- ruby 3.0
- nodejs v16.19
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.
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>
The component app
can be placed anywhere in your page.
This project makes use of the following works: