Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
9654352
Add design spec for fullstack layers perspective
mavishay Jun 1, 2026
9b77100
feat: add implementation plan for fullstack layers perspective
mavishay Jun 1, 2026
b1e752a
chore: fix assests typo, add VISION.md and CONTRIBUTING.md
mavishay Jun 1, 2026
536f6f6
docs: add layers perspective section to README and update CODEOWNERS
mavishay Jun 1, 2026
57ee5fe
feat: add layers intro and cross-reference matrix
mavishay Jun 1, 2026
7128411
feat: add Layer 1 - Frontend article
mavishay Jun 1, 2026
16179a8
feat: add Layer 2 - APIs & Backend Logic article
mavishay Jun 1, 2026
7a90355
feat: add Layer 3 - Database & Storage article
mavishay Jun 1, 2026
646f5d0
feat: add Layer 4 - Auth & Permissions article
mavishay Jun 1, 2026
d308978
chore: fix trailing whitespace in Layer 3
mavishay Jun 1, 2026
c68c713
feat: add Layer 5 - Hosting & Deployment article
mavishay Jun 1, 2026
c893ea9
feat: add Layer 6 - Cloud & Compute article
mavishay Jun 1, 2026
68ce410
feat: add Layer 7 - CI/CD & Version Control article
mavishay Jun 1, 2026
040d1cf
feat: add Layer 8 - Security & RLS article
mavishay Jun 1, 2026
680979e
feat: add Layer 9 - Rate Limiting article
mavishay Jun 1, 2026
4a1f19a
feat: add Layer 10 - Caching & CDN article
mavishay Jun 1, 2026
70d1e3c
feat: add Layer 11 - Load Balancing & Scaling article
mavishay Jun 1, 2026
fd2eab2
feat: add Layer 12 - Error Tracking & Logs article
mavishay Jun 1, 2026
17583f9
feat: add Layer 13 - Availability & Recovery article
mavishay Jun 1, 2026
9ada2d7
feat: add cover images for layers perspective
mavishay Jun 1, 2026
31742a7
chore: final formatting pass on layers perspective
mavishay Jun 1, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion CODEOWNERS
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
articles/* @mavishay
articles/* @mavishay
layers/* @mavishay
22 changes: 22 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Contributing

We welcome contributions from Tikal team members and the broader fullstack community.

## How to Contribute

1. **Discuss first** — Open an issue or start a discussion to propose changes before writing
2. **Branch strategy** — All work happens on feature branches (e.g., `factor-N-topic`). The `next` branch accumulates changes for the next release. `main` is the current approved version.
3. **Style guide** — Follow the existing article format: cover image, consistent heading hierarchy, case studies grounded in real experience, code examples with language annotations, cross-references to related factors.
4. **Review** — All articles require review by a maintainer. CODEOWNERS defines who must approve changes to each directory.
5. **Commit messages** — Use conventional commits format: `feat:`, `fix:`, `docs:`, `refactor:`
6. **Images** — Place cover images in `images/`. Source files (PSD, Sketch, Figma) go in `assets/`.

## Getting Started

- Read `VISION.md` to understand the project's goals
- Check the README table for articles needing owners
- Review existing articles for style and structure

## Code of Conduct

Be respectful, constructive, and inclusive. Focus on what's best for the guide and its readers.
24 changes: 24 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# The Modern Full-Stack Developer's Guide: A 12-Factor Approach
This is the repository for the text of the updated version of the "The Modern Full-Stack Developer's Guide: A 12-Factor Approach
" manifesto, which will ultimately replace the one published on medium. The text is located in the articles directory. As noted in the governance document, changes will occur in the next branch until the maintainers agree that the current round of updates is complete.

We've also developed a complementary [Layers Perspective](layers/00-Intro.md) that covers the backend, infrastructure, and operations side of fullstack development.
## Vision
The details of our vision for the update can be found in VISION.md
## How to Participate
Expand Down Expand Up @@ -30,3 +32,25 @@ Information on participating is in CONTRIBUTING.md
| [Supplemental Factor 1: Testing strategies](https://github.com/tikalk/full-Stack-12-factors/blob/main/articles/13-Supplemental-factor-1.md) | @mavishay | 🟢 | 🟢 | ⚪️ | | | | | |
| [Supplemental Factor 2: Observability & Error Management](https://github.com/tikalk/full-Stack-12-factors/blob/main/articles/14-Supplemental-factor-2.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ | | | | | |
| [Supplemental Factor 3: Micro-frontend architectures](https://github.com/tikalk/full-Stack-12-factors/blob/main/articles/15-Supplemental-factor-3.md) | @mavishay | 🟢 | 🟡 | ⚪️ | | | | | |

## Layers Perspective (Complementary View)

A second lens on fullstack development — covering the backend, infrastructure, and operations layers that complement the 12 factors above.

| Layer | Owner | Created | Approved | Published |
|-------|-------|---------|----------|-----------|
| [Intro](layers/00-Intro.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 1: Frontend](layers/01-Layer-1-Frontend.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 2: APIs & Backend Logic](layers/02-Layer-2-APIs-and-Backend-Logic.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 3: Database & Storage](layers/03-Layer-3-Database-and-Storage.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 4: Auth & Permissions](layers/04-Layer-4-Auth-and-Permissions.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 5: Hosting & Deployment](layers/05-Layer-5-Hosting-and-Deployment.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 6: Cloud & Compute](layers/06-Layer-6-Cloud-and-Compute.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 7: CI/CD & Version Control](layers/07-Layer-7-CICD-and-Version-Control.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 8: Security & RLS](layers/08-Layer-8-Security-and-RLS.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 9: Rate Limiting](layers/09-Layer-9-Rate-Limiting.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 10: Caching & CDN](layers/10-Layer-10-Caching-and-CDN.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 11: Load Balancing & Scaling](layers/11-Layer-11-Load-Balancing-and-Scaling.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 12: Error Tracking & Logs](layers/12-Layer-12-Error-Tracking-and-Logs.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Layer 13: Availability & Recovery](layers/13-Layer-13-Availability-and-Recovery.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
| [Cross-Reference Matrix](layers/LAYERS-MATRIX.md) | @mavishay | ⚪️ | ⚪️ | ⚪️ |
12 changes: 12 additions & 0 deletions VISION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Vision

The Modern Full-Stack Developer's Guide: A 12-Factor Approach aims to define a comprehensive, practical methodology for building modern full-stack web applications. Drawing on the collective experience of 50+ Tikal full-stack experts, this guide updates the original 12-factor app methodology for a world where frontend complexity, cloud infrastructure, and developer experience are first-class concerns.

Our vision is a guide that:
- Serves as the definitive reference for fullstack developers at every career stage
- Bridges the gap between frontend, backend, and infrastructure concerns
- Provides actionable patterns, not abstract theory
- Evolves through community contribution and real-world practice
- Covers the full stack from UI components to cloud deployment

This repository contains the source text for the guide. The latest stable version is published on Medium. The `main` branch represents the current approved version; development happens in feature branches and the `next` branch until maintainers agree updates are complete.
File renamed without changes.
File renamed without changes.
Loading