Skip to content

docs(architecture): add default web application stack guidance#71

Open
jdhoffa wants to merge 2 commits into
mainfrom
docs/default-web-stack
Open

docs(architecture): add default web application stack guidance#71
jdhoffa wants to merge 2 commits into
mainfrom
docs/default-web-stack

Conversation

@jdhoffa

@jdhoffa jdhoffa commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator
  • Gains architecture/web_stack.md establishing React + FastAPI + PostGreSQL as the default stack for new web applications at RMI
  • Also lists adjacent tooling suggestions (non-perscriptive): uv, ruff, pytest, Alembic, etc.
  • Gives RMI/stitch as a working example

@jdhoffa jdhoffa requested review from a team, AlexAxthelm, HughRunyan, andre-scheinwald, atecza-rmi, cjyetman, jacobvjk and mbarlow12 and removed request for a team July 6, 2026 14:55
Comment thread architecture/web_stack.md
- **Backend / API:** [FastAPI](https://fastapi.tiangolo.com/) (Python)
- **Database:** [PostgreSQL](https://www.postgresql.org/)

This is a default, not a mandate. But the default exists for a reason: shared tooling, transferable knowledge across teams, easier code review, and lower onboarding cost enable better engineer fungibility across repositories.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Noting that this assumes python, rather than other languages that the project might want to use.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a feature, not a bug :)

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should be targeting this stack (and Python) as a default for SPD. For both internal and contracted work.

A great counter-example of this is the PACTA web application built by Silicon Ally, which is written in Go (a language that precisely 0 of our engineers knows): https://github.com/RMI-PACTA/app

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or any of the demos I wrote in Ruby. Definitely did not help me sell those ideas :-)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants