🏆 Admin-app 2024 golden path [DRAFT]

[matheusps]

Thoughtworks Tech Radar

Frontend framework

• 🏆 Adopt: raccoon, next-js (pages), react > 17.
• 🟢 Trial: nextjs (app).
• 🟠 Assess: remix, vite.
• 🔴 Hold: render-runtime, react < 17, gatsby.

Styling ✅

TL;DR

• Use Shoreline Tokens.
• Prefer styling with Vanilla CSS, CSS-Modules, and Sass.
• Prefer PostCSS as processor.
• While using Sass, prefer the .scss syntax.
• Avoid atomic CSS and runtime CSS-In-JS.

The RTG

• 🏆 Adopt: @vtex/shoreline-tokens, CSS, postcss, css-modules, sass.
• 🟢 Trial: lightningcss.
• 🟠 Assess: vanilla-extract, pandacss.
• 🔴 Hold: emotion, styled-components, stitches, tailwindcss, tachyons.

Testing [TBD]

• 🏆 Adopt: jest, cypress, storybook.
• 🟢 Trial: playwright, chromatic.
• 🟠 Assess: vitest.
• 🔴 Hold: TBD

1. Unit: Jest vs Vitest
2. E2E: Playwright vs Cypress

Repository

• 🏆 Adopt: turborepo, lerna, pnpm, husky, plopjs, commitlint, commitizen, eslint, prettier.
• 🟢 Trial: changesets, yarn.
• 🟠 Assess: nx.
• 🔴 Hold: yarn v2+, bun.

Localization

• 🏆 Adopt: react-intl, crowdin.
• 🟢 Trial: -.
• 🟠 Assess: i18n-next.
• 🔴 Hold: -.

Host [TBD]

• 🏆 Adopt: Vercel.
• 🟢 Trial: -.
• 🟠 Assess: -.
• 🔴 Hold: Netlify, AWS-Amplify, Web-Ops.

[marcelovicentegc]

Frontend framework

If we are to place NextJS app router on trial, I think it's fair to move Remix there as well.

Styling

BACK WITH THE OLD SCHOOLERS: LGTM 👍

Testing [TBD]

LGTM 👍

Repository

I only miss semantic-release in the list. I would encourage teams to adopt it as well. Personally, it's my favorite for its simplicity.

Localization

It occurs to me that we could move i18n-next under our Adopt matrix. It's a stable framework and has been around for more time then react-intl (8 years +).

Host

I know no one mentioned it, but it occurs to me that we should at least list Cloudflare Workers/Pages under hold. Also, I will go after some verdict after NextJS Admin Apps Provider Proposal.

Documetation

We should encourage teams to use mermaid to document their systems.

[kevinch]

About Business Metrics (Analytics), we got a PR being reviewed for the internal docs.