From 8d96de991d78a32f59bcf544d045cea38348e4d1 Mon Sep 17 00:00:00 2001 From: Wes Risenmay Date: Wed, 20 May 2026 11:02:52 -0600 Subject: [PATCH 1/2] docs: added an ADR for our choice in Meta Framework --- .../0005MetaFramework.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 architectureDecisionRecords/0005MetaFramework.md diff --git a/architectureDecisionRecords/0005MetaFramework.md b/architectureDecisionRecords/0005MetaFramework.md new file mode 100644 index 0000000000..3abfd756cd --- /dev/null +++ b/architectureDecisionRecords/0005MetaFramework.md @@ -0,0 +1,27 @@ +# Title + +Meta Framework + +## Date proposed + +05-20-2026 + +## Context + +React has been recommending for the past 3 years to use a meta framework. They have been pushing the community towards SSR and React Server Components. There are multiple meta frameworks that support these. + +The top 3 are + +1. [NextJS](https://nextjs.org/) (~36,000,000 weekly downloads) (55% positive sentiment) +1. [React Router v7 Framework Mode/Remix](https://reactrouter.com/) (~2,300,000 weekly downloads) (68% positive sentiment) +1. [Tanstack Start](https://tanstack.com/start/latest) (~38,000 weekly downloads) (No data for sentiment) + +## Decision + +When building new apps we will default to NextJS. If a frontend project doesn't make sense to build in NextJs, then we can build it with our old stack of Vite and React. + +## Consequences + +We won't be able to just push our NextJS apps up to an S3 bucket. We will have to deploy them. Engineers will have to learn the NextJS framework. We will have to worry about server and client side state. + +Users of our products will get faster page load times due to SSR. We have the option of building our backend in typescript with NextJS. From 128d0659ea4851cae829655ffaaac176396b5f97 Mon Sep 17 00:00:00 2001 From: Wes Risenmay Date: Wed, 20 May 2026 11:14:07 -0600 Subject: [PATCH 2/2] improve ADR --- architectureDecisionRecords/0005MetaFramework.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/architectureDecisionRecords/0005MetaFramework.md b/architectureDecisionRecords/0005MetaFramework.md index 3abfd756cd..68c1b14c69 100644 --- a/architectureDecisionRecords/0005MetaFramework.md +++ b/architectureDecisionRecords/0005MetaFramework.md @@ -16,6 +16,10 @@ The top 3 are 1. [React Router v7 Framework Mode/Remix](https://reactrouter.com/) (~2,300,000 weekly downloads) (68% positive sentiment) 1. [Tanstack Start](https://tanstack.com/start/latest) (~38,000 weekly downloads) (No data for sentiment) +Tanstack start seems really promising, but it's still an RC. React Router v7 also looks really promising, but Remix has had years to build adoption and hasn't gained a lot of traction. + +NextJS has been the industry standard for a long time, and it is used way more than the other frameworks, so it feels like the safest bet. + ## Decision When building new apps we will default to NextJS. If a frontend project doesn't make sense to build in NextJs, then we can build it with our old stack of Vite and React.