Illustrations and Graphics
Working guidance for functional diagrams, relationships, comparisons and accessible visual explanations.
The smallest useful visual explanation
JR Dream’s working direction is Functional Architectural Graphics. Use restrained graphics to explain order, relationships and responsibility when they improve understanding. This supporting system reuses the existing foundations rather than creating new brand symbols.
Start with text. Choose photography when a real environment, person or physical condition matters; an accepted icon and label when a familiar action needs a scanning cue; a diagram when a relationship, decision or handover needs explanation.
These are internally accepted working specifications, pending implementation testing and final company approval. Every example here is an instructional schematic, not verified JR Dream operations, property data, reporting authority or a delivery commitment.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 1 and 10.
Functional graphics, without decorative scenes
Information-bearing graphics must answer a specific question. Show useful order, responsibility, association or comparison with clear labels and the fewest useful elements. A fact, instruction or short list often needs no diagram.
The source adopts no conceptual illustration library. Characters, mascots, isometric cities, fake digital infrastructure and custom empty-state scenes are excluded at this stage. Revisit conceptual illustration only for a specific unmet explanatory need after simpler formats fail.
Architectural geometry supplies a restrained structure, not a licence to invent site plans or graphic motifs. The complete logo stays unchanged; never extract its skyline, circuitry or emblem as a node, connector or decoration.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 1–2 and 7–10.
Source-supported graphic categories
| Format | Purpose | Restriction |
|---|---|---|
| Flow / handover | Order, an action, a sender/receiver or response needs explanation. | Number steps and name roles. Verify actual owners, sequence and exceptions; an arrow promises no automation or response time. |
| Decision | A question has explicit labelled outcomes. | Use a 4px rectangular question node and label every Yes / No route. Do not invent a return loop or approval condition. |
| Relationship / hierarchy | Association or parent-child structure is easier to inspect visually. | Plain lines mean association, not sequence. Label levels and relationships; organisational authority needs verified roles. |
| Comparison | Criteria or exact mappings need inspection. | Use clear dimensions; a matrix is often clearer than a decorative cluster. |
| Timeline | Phases or chronology need explanation. | State whether spacing means order or elapsed time. Approved dates are required for a factual schedule. |
| Basic chart, conditional | A real information need and useful data exist. | Title, units, period/source, zero baseline for bars, direct labels and a data/text equivalent. Synthetic data must be labelled; omit when unnecessary. |
The source’s small master set is Flow, Decision, Relationship, Comparison and Timeline. These formats do not establish a measured architectural drawing standard or a decorative illustration style. A chart is conditional on a real need; none is added here because there is no approved dataset to explain.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 1 and 3–5, 9.
Construction, spacing and live labels
| Role | Existing token / resolved value | Use |
|---|---|---|
| Structural group | --radius-none0px | Square groups; do not turn structure into a brand symbol. |
| Process / decision node | --radius-control4px | Rectangular labelled nodes, not unexplained shape legends. |
| Card-like outer group | --radius-container8px | Only when the outer group actually has a card role. |
| Node border | --border-thin1px | With --border-control for meaningful boundaries. |
| Node boundary colour | --border-control#7F7B71 | --border-default is decorative only. |
| Connector stroke | --border-strong2px | Straight/orthogonal, preferably solid; do not pass through labels. |
| Connector colour | --text-secondary#635F57 | Different from Lucide's scaled 2-unit stroke system. |
| Open arrowhead | --space-088px | 8 × 8px, with the same connector stroke. |
| Node padding | --space-1616px | Height grows with live labels. |
| Sequence gap | --space-3232px | Space reserved for the connector, not text. |
| Related-group spacing | --space-2424px | Separate related explanations without ornamental rules. |
Node labels use Inter 16px / 1.4, weight 500; Arabic uses IBM Plex Sans Arabic 18px / 1.5, weight 500. Supporting roles use English 14px / 1.5 and Arabic 16px / 1.65. The examples use existing UI/body-small aliases so user font scaling and language rules remain effective.
Keep alignment deliberate, straight or orthogonal routes clear of text, and related groups 24px apart. Aim for 3–5 nodes per view as an editorial limit; split larger explanations into linked sections or a text equivalent. Heights grow with labels, rather than shrinking the type.
Diagram connector width is 2 CSS pixels. Lucide retains its separate 2-unit design stroke that scales with its icon canvas. Do not modify icon paths or strokes to imitate diagram connectors.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 2 and 9.
Colour, meaning and contrast
Use white/warm-white surfaces, charcoal labels and secondary-text connectors. Accessible action orange supports selected emphasis. Functional status colours apply only to an actual stated status, never an ordinary category or decorative scene. No gradients or new multicolour palette are introduced.
| Pair | Existing foreground / background | Source ratio | Meaningful use |
|---|---|---|---|
| Connector / white | --text-secondary #635F57--surface-primary #FFFFFF | 6.35:1 | 3:1 |
| Connector / warm white | --text-secondary #635F57--surface-secondary #F7F4ED | 5.78:1 | 3:1 |
| Node boundary / white | --border-control #7F7B71--surface-primary #FFFFFF | 4.22:1 | 3:1 |
| Label / white | --text-primary #252827--surface-primary #FFFFFF | 14.88:1 | 4.5:1 |
| Decorative separator / white | --border-default #DED8CC--surface-primary #FFFFFF | 1.42:1 | Below 3:1; decorative only |
Independent recalculation matches all 5 source pairs to two decimals. These numerical checks do not certify a complete accessible graphic. A decorative separator is not a meaningful node boundary. Do not encode an important distinction through colour, thickness or a dashed line alone.
This source-based node recipe uses existing selection roles. The documentation sidebar’s accepted solid orange/white selection remains its own implementation choice, unchanged by this page.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 2, 5 and 9.
Order, decisions and relationships
Illustrative only. Roles and actions are not a JR Dream workflow.
- Role A1. Share item A
- Role B2. Review item A
- Role A3. Receive response
Text equivalent: Role A shares item A with Role B. Role B reviews it; Role A then receives a response. The arrows state order and handover only, not an automated system, response time or verified responsibility.
- Yes: outcome A
- No: outcome B
Text equivalent: If condition A is met, choose outcome A; otherwise choose outcome B. Both branches end here. No return route or approval condition is asserted.
- B: member of Group A
- C: member of Group A
Text equivalent: B and C are members of Group A. Plain lines indicate association, not sequence, organisational reporting or a shared software platform.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 3–4 and 6.
Use graphics only where they help
| Context | Use |
|---|---|
| Corporate / service explanation | A labelled relationship, comparison or short flow when it explains something text alone does not. Validate service connections before publication. |
| Operational instruction / onboarding | Start with a short ordered list; add a flow only where branches, responsibility or relationships materially improve understanding. |
| Status / validation | Use an existing status message and accepted feedback icon, not an explanatory scene. |
| Navigation / common action | Standard text and icon with meaningful boundaries and at least 48px interactive targets. |
| Empty state | Explain the empty view and next useful action. A clear label and accepted icon are sufficient; no custom scene. |
| Complex mobile process | Split into steps with text equivalents. Do not require pinch-zoom, hover-only labels or colour decoding. |
Keep an explanation near its task. It is not a persistent decorative background. Documentation can use these same formats without claiming that a future product or workflow already exists.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 1, 4 and 7.
Graphics, icons and photography have different jobs
Iconography supplies a familiar scanning cue alongside a label. A functional graphic explains several steps or relationships. Photography explains a real environment or physical condition, under the existing rights and authenticity rules.
Do not enlarge an icon into a new illustration language, redraw approved glyphs, stylise a photograph into a substitute graphic, or reuse the logo as diagram material. This page uses no photographs or new icon assets. Conceptual illustration and architectural motifs are not adopted by this stage.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 1–2 and 7–10.
Clear versus ambiguous explanations
| Use | Avoid |
|---|---|
| 3–5 useful nodes and a structured text equivalent. | A dense diagram that forces labels to caption size or requires pinch-zoom. |
| Numbered steps, verbs, generic roles until verified. | Unverified departments, response times, software features or approval steps. |
| Question node with every branch labelled. | Unexplained shape legends, orphaned arrows or loops without a defined return point. |
| Plain labelled association and explicitly named hierarchy levels. | Proximity presented as authority, or service grouping presented as an organisation chart. |
| Direct labels, units and data equivalent for a justified chart. | 3D, misleading axes, colour-only legends or synthetic figures presented as performance. |
| Text or a comparison matrix when exact mappings matter. | Decorative clusters, repeated building silhouettes or custom visual scenes. |
| Criterion | Option A | Option B |
|---|---|---|
| Criterion A | [Approved description] | [Approved description] |
| Criterion B | [Approved description] | [Approved description] |
- Phase A[Date / period]
- Phase B[Date / period]
- Phase C[Date / period]
Text equivalent: Phase A, then Phase B, then Phase C. Equal columns express reading order only, not equal duration or a committed schedule.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 3–5 and 7–8.
Readable, responsive and bilingual
Provide a short purpose and visible structured text describing every essential step, branch and relationship. Use live HTML for labels and order where practical. Meaningful standalone SVGs need an accessible title/description; hide redundant connector imagery when the labels and text already provide its meaning.
The source allows horizontal steps only at 768px and above when labels fit. Stack below that width, and earlier when longer copy or doubled text makes a row difficult. This is a diagram-fit rule, not a new page-grid band. These examples additionally require sufficient local width in rem units; nodes keep their type size and grow naturally.
Reading order remains semantic when layout changes. RTL requires separately reviewed wording, role placement and arrow direction, not a reflection of the entire graphic. Preserve the logo, category icons, numbers and reference IDs; use bdi for mixed identifiers. No unreviewed Arabic source sample or invented Arabic wording is used.
All specimens are static explanations, not interactive nodes. If later made interactive, use appropriate native controls, meaningful names, keyboard operation, visible focus and existing minimum targets. Do not introduce hover-only explanations. Contrast and automated layout checks alone do not certify comprehensive accessibility.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 2, 6–7 and 10.
Documents and presentations
| Application | Working reference and limitation |
|---|---|
| A4 profile / proposal | 170 × 259mm live area; EN 11pt / AR 12.5pt body. Retain process/service qualifiers with the content. |
| 16:9 slides | 960 × 540pt; 48pt inline / 36pt block safe margins; 32pt heading and 22pt English body in these specimens. |
| Physical graphics | Square/4px-equivalent role geometry is authored as a physical recipe; .75pt node border and 1.5pt connector are starting proof values, not new web tokens. |
| Output | Keep labels editable in native masters. Dense processes must not be reduced to caption size. Import, reading order, projector visibility and actual-size print proof remain pending. |
CSS pixels, points and millimetres remain separate. Vector geometry can scale, but labels and meaning still need review at the intended size. The website’s PDF export demonstrates complete content flow, not validation of the native physical recipes.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 8–10.
Implementation and asset governance
.graphic-node {
padding: var(--space-16);
border: var(--border-thin) solid var(--border-control);
border-radius: var(--radius-control);
background: var(--surface-primary);
color: var(--text-primary);
font-size: var(--type-ui-size);
font-weight: var(--weight-medium);
line-height: var(--type-ui-leading);
min-inline-size: 0;
overflow-wrap: anywhere;
/* No fixed block height. Labels stay live and can wrap. */
}
.graphic-connector path {
fill: none;
stroke: var(--text-secondary);
stroke-width: var(--border-strong);
}
/* Use --space-32 between steps and --space-24 between related groups.
Start with a vertical list; use horizontal steps only at >=768px
AND when the available width and enlarged labels fit.
This diagram-fit rule does not replace the page grid bands.
Keep connectors in reserved space, outside node text. */<figure aria-labelledby="example-purpose">
<figcaption id="example-purpose">Association example, not an operating model</figcaption>
<svg width="32" height="8" viewBox="0 0 32 8"
role="img" aria-labelledby="line-title line-desc" focusable="false">
<title id="line-title">Association line</title>
<desc id="line-desc">Plain line, not a sequence arrow.</desc>
<path d="M0 4H32" fill="none"
stroke="var(--text-secondary)" stroke-width="var(--border-strong)" />
</svg>
<p>Text equivalent: B is associated with A; no order is implied.</p>
</figure>
<!-- With equivalent adjacent wording, hide a redundant connector SVG
using aria-hidden="true" and focusable="false" instead.
IDs must be unique for every informative instance.
In React, a title's children must be a single string. -->// Keep one content record with stable node IDs and semantic order.
// Translate/review labels separately; do not mirror a whole SVG.
// In horizontal RTL flow, resolve directional connectors toward the
// next semantic step. Vertical order remains top-to-bottom.
// Preserve the logo, category icons, numbers and reference identifiers.
// Isolate mixed identifiers: <bdi dir="ltr">JRD-GFX-001</bdi>.
// HTML/CSS suits live, wrapping labels and ordered relationships.
// SVG suits simple vector paths with purpose/title/description.
// If exporting outlined text or a flattened image, retain a complete
// accessible structured text equivalent and an editable master.
// Re-route connectors after content changes; never cover text with lines.The proposed Graphic aliases in the PDF map to existing values; they are not a parallel token architecture. These specimens use the central tokens directly. The local fit threshold is a documentation implementation choice, not a new brand breakpoint. No production component API or Figma library is created.
For future masters, retain stable node IDs, one authoritative content record, semantic order, editable text and variable-height frames. Update wording/roles/branch labels in the master and re-route connectors after reflow. Create a separate layout variant only when needed.
Prefer SVG for simple vectors and PNG only when the receiving application cannot render SVG reliably. Keep editable masters and full text equivalents for outlined or flattened exports. Record ID, purpose, language, master/source, version, content owner, hypothetical/verified status, approval and text description. Keep masters, language exports, content/descriptions and licences organised without adding an asset-management platform.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 6 and 9–10.
Validation and approval status
The source reports 20 WeasyPrint/Pango process width simulations, font rendering, selected contrast calculations and static PDF review. These are source-study results, not browser or assistive-technology certification for this application.
Tests executed for this page are recorded in docs/stage-02.2h-implementation.md. The canonical URL remains /docs/foundations/graphics; the requested Illustrations URL redirects to it without a duplicate page or navigation entry.
- Actual roles, branches, responsibilities, service associations, dates, datasets and exceptions require business validation before a factual diagram is published.
- Competent Arabic review, approved bilingual labels, real RTL reading order and mixed-content checks remain pending.
- Screen readers, real devices, other browsers, actual zoom/reflow, text-spacing overrides and native forced-colours review remain pending.
- Native export/import, editable SVG text/fallback, accessible PDF structure, physical print/projector proof and final company approval remain pending.
These are documentation-only explanations. No production illustration library, corporate website or new motif system is created. Final company approval remains pending.
Source: Illustrations & Graphics Exploration & Validation v1.0, pages 9–10.