Improve code consistency and documentation readability

- Standardized Markdown formatting across documentation files.
- Fixed inconsistent usage of inline code blocks and improved syntax clarity.
- Updated tests and JSX for cleaner formatting and better readability.
- Adjusted E2E test navigation handlers for multiline code consistency.
- Simplified TypeScript configuration and organized JSON structure for better maintainability.
This commit is contained in:
Felipe Cardoso
2025-11-20 12:58:46 +01:00
parent 28b1cc6e48
commit 8fdbc2b359
13 changed files with 53 additions and 46 deletions

View File

@@ -1,18 +1,22 @@
# Visual Identity
## Logo & Iconography
*Pending logo design.*
_Pending logo design._
For now, we use the **Lucide React** icon set for all iconography. Icons should be used sparingly and meaningfully to enhance understanding, not just for decoration.
## Color Palette
Our color palette is derived from the **Modern Minimal** theme using the **OKLCH** color space for perceptual uniformity.
### Primary Colors
- **Primary Blue**: `oklch(0.6231 0.188 259.8145)` - Used for main actions, branding elements, and active states.
- **Background**: `oklch(1 0 0)` (Light) / `oklch(0.2046 0 0)` (Dark) - Clean, neutral backgrounds.
### Usage Guidelines
- **Dominant**: Neutral backgrounds and text (Foreground, Card, Muted).
- **Accent**: Primary Blue for calls to action.
- **Functional**: Destructive Red for errors, Success Green (custom) for success states.
@@ -21,9 +25,11 @@ Our color palette is derived from the **Modern Minimal** theme using the **OKLCH
> For the full technical specification of color tokens, refer to the [Design System Foundations](../design-system/01-foundations.md#color-system-oklch).
## Typography
We use **Geist Sans** for headings and body text, and **Geist Mono** for code.
### Type Hierarchy
- **Headings**: Bold, tight tracking.
- **Body**: Regular weight, comfortable reading line height.
- **Code**: Monospaced, slightly smaller than body text.
@@ -32,6 +38,7 @@ We use **Geist Sans** for headings and body text, and **Geist Mono** for code.
> For the full typography scale and usage, refer to the [Design System Foundations](../design-system/01-foundations.md#typography).
## Imagery & Graphics
- **Style**: Clean, modern, minimal.
- **Screenshots**: Use consistent padding and shadows (refer to `shadow-lg` or `shadow-xl`).
- **Illustrations**: Avoid generic stock photos. Use abstract geometric shapes or high-quality interface representations.