Date: 2022-08-16
Accepted
In deciding how content would be delivered to the end user, we held a meeting with Engineering and Design and the mayor of Igorville 1 and consulted the 18F Engineering Practices Guide.
The two major options considered were 1) a single page application, developed with a JavaScript framework such as React, perhaps served from its own Node-based server or a static file host such as Federalist; or 2) traditional server rendered HTML pages, delivered by Django, accompanied by a small amount of JavaScript and CSS.
To use server-side rendering performed by Django.
The positive aspects of this include: easier state management, fewer bugs caused by stale cache data, easier 508 compliance for disabled users, better maintainability for future developers due to fewer dependencies and a shallower learning curve, and better cross browser compatibility.
The risks to this approach are given by the frontend lead on a sister 18F project: a less well-developed API since this approach does not require an API upfront, users/stakeholders attempting to request ever increasing levels of interactivity, and familiarity with vanilla.js has waned over the years.
Footnotes
-
Inside joke. To obtain access to the registrant flow, a member of our team signed up for .gov using the fictitious town of Igorville. ↩