The Arches Data Viewer is a WIP 'Arches Application', an extension of the Arches Project. The goal of this project is to create an isolated front-end component that consumes data from the Arches platform.
An Arches Application is itself a Django Application, which can be installed into an existing instance of Arches.
The code in the archesdataviewer folder is modeled off of this repository. Currently,
it is used only to serve the front-end component as bundeled javascript.
The front-end folder contains a Vue Application, built with Vite and Typescript. The ultimate goal of this application is to provide an alternative UI to the current Arches platform, using a modern web framework like Vue. Currently, the Vue code is bundled by vite into the static directory of the Django Application, which is then served on the user's Arches server.
Credits to users @apeters and @chiatt
In order to install the Arches Data Viewer Application into arches, follow these steps
-
Install if from this repo (or clone this repo and pip install it locally).
pip install git+https://github.com/OpenTechStrategies/arches-app-exp.git -
Add 'archesdataviewer' to the ARCHES_APPLICATIONS and INSTALLED_APPS settings in the demo project's settings.py file
ARCHES_APPLICATIONS = ("archesdataviewer",) # be sure to add the trailing comma!
INSTALLED_APPS = [
...
"archesdataviewer",
]- Update your urls.py file in your project. You'll likely need to add the re_path import:
from django.urls import include, path, re_pathand then the following path:
re_path(r"^", include("archesdataviewer.urls")),- From your project run migrate to add the model included in the app(This step is currently unecessary as the django app does not provide any new models, but may become needed in the future):
python manage.py migrate - Navigate to
http://{your_arches_instance_url}/archesdataviewer
A long-term goal of this application is to be a jumping off point for customizing an Arches user experience.
TBA more details on front-end development in the near future.
Currently, if you wish to develop the base front-end, the workflow has been set up with vite to build the static assets into the django application, along with dynamic imports of the bundled JS and CSS files.
Example front-end dev workflow:
- Fork this repository
- See front-end/README.md for vue setup Instructions
- Develop vue code
- Run npm run build
- Uninstall the current version of this application on your arches instance with
pip uninstall archesdataviewer - Reinstall the application with
pip install git+https://github.com/{YourGithubForkURL}