Overview
gmz.dev is meant to behave like a README for the tools and systems in use – not a marketing site. The goal is to keep a plain record of what exists, how it works at a high level, and where to look if more detail is needed.
Tone guideline: write as if explaining the system to yourself six months from now.
Scope
- Small calculators and logic layers (SiteTax and related tools).
- iOS pipelines (Watermarkd and similar tools).
- Links to fuller docs or external surfaces when they exist.
Notes on style
- Prefer simple language over clever names.
- Capture assumptions; they are easy to forget.
- Short sections are fine; this is allowed to be incomplete.
Systems (current)
Short descriptions only. Detailed diagrams or code should live in separate docs or repositories.
SiteTax calculator logicstatus: shipping
Logic to decide when work is treated as taxable repair vs. capital improvement (NJ focus). Backed by a few clear rules rather than a giant decision tree.
- Inputs: job description, location, type of work, form flags (if supplied).
- Outputs: taxable / non-taxable result, with a simple explanation.
- Constraint: better to be explicit about assumptions than silently guess edge cases.
Watermarkd rendering pipelinestatus: v1
iOS pipeline for importing an image, applying text/graphic overlays, and exporting at a predictable size and quality.
- Inputs: source image, overlay text, position/scale, export settings.
- Outputs: exported image ready for sharing or posting.
- Considerations: export performance, safe text sizes, and not overcomplicating the controls.
Doc: /docs/watermarkd-pipeline.html
Docs (entry points)
These are suggested entry points for deeper documentation. They live as separate HTML
files under /docs.
- Docs index – /docs/index.html map
Architecture overviewplanned
High-level description of how front-ends (Next.js, SwiftUI) connect to engines (SiteTax, pipelines, future tools) and storage (SQLite, Firestore, etc.).
Patterns & interfaceswip
Notes on shared UI patterns (inputs, result cards, sliders, export flows) and internal API shapes that keep tools consistent.
Doc: /docs/patterns.html
Notes / logongoing
A running text file or log for small decisions that are too minor for a big doc but worth recording (e.g. tax edge case tweaks, export defaults).
Doc: /docs/notes.html
Links / other surfaces
gmz.dev is meant to be the engineering / documentation side. Other public-facing surfaces:
- gomezsystems.com – studio / services and more polished descriptions.
- gomez.studio – visual and creative work.
- Additional apps, tools, or repos can be added here as they stabilize.
internal note (not public-facing): operations handbook lives under
/internal/handbook.html and related pages, protected separately.