Philosophy

TGRStack in a few words

Dev Speed is most important, Dev friendly, Strong but Lean, Durable, Re-usable, Magicless.

Developer Speed

1. The right tool for the job means you need a Toolbox
2. As a codebase ages, its natural for non-relevant or reusable code to be refactored into their own, specific, codebases.
3. A stack can significantly slow down a developer if:
   1. Its difficult to configure or understand how to modify
   2. hot rebuild times are more than 300ms
   3. coding style is inconsistent
   4. coding style is convoluted or bulky

Developer Friendly

Starter-Kits/Templates/Boilerplates - an organization’s architects should be able to modify a/this third-party Toolbox to set a standard for development teams. The third-party toolbox (TGR-stack) can be kept as an upstream to get some updates until they diverge too much.

• vscode extension: code-snippets
• vscode extension: suggested-extensions
• git formatted commit prompt: commitizen with emojis (cz-emoji w/ gitmoj)
• advanced package scripting: nps
• Extensive documentation and wiki
• Examples for the majority of cases
• StackOverflow w/ TGRStack in question title for long-term Q&A
• Slack server for community support and contributor coordination

Strong but Lean

Perfection is not adding as much as possible, but when nothing can be taken away

Durable

Durability goals should be set per project. Note that some durability improvements, namely testing, add incremental weight to code changes. Define your projects durability by how long will the project fulfill its purpose without any updates, refactoring, etc.

Reusable

Two principles are very important to make reusable codebases:

1. modularity championed by NPM
2. microservice architecture championed by Netflix.

Create a modular heirarchy so that services, apps, modules, and components are in separate repositories and each one can standalone.

Magicless

At first glance TGRstack appears to hide all of its internals but instead of wrapping everything up into a react-scripts package (popularized by Create React App), all the knobs are at your disposal by disabling the 'hidden' flags in the workspace vscode configuration (.vscode/settings.json). This is equivalent to a project running react-scripts eject which most advanced devs use as a matter of course.