Carlos Eduardo Gatti Ferreira

Getting Started

A quick guide to understanding and working with this monorepo.

What Is This?

This is a frontend monorepo containing multiple applications:

Personal Website — Portfolio and blog (/pages)
Discart-me — Community marketplace (/app/discart-me)
QRACK — Inventory management system (/app/qrack)

All apps share code, components, and infrastructure while maintaining clear boundaries.

New to the codebase?

Start with Architecture to understand the system
Read Monorepo Structure to learn how code is organized
Review Conventions before writing code

Looking for specific information?

Architecture questions → Architecture Overview
Where to put code → Monorepo Structure
How to code → Coding Conventions
Why something exists → Architectural Decisions or /docs/05-adr/
App-specific → /app/{app}/README.md
Library usage → /src/{library}/README.md

Documentation System

All documentation lives in Markdown (.md) files:

✅ Single source of truth (no duplication)
✅ Renders natively on GitHub
✅ Ready for documentation websites
✅ Can be reused in personal website

See Documentation Hub for the complete documentation structure.

Next Steps: Read the Architecture Overview to understand the system design.