OSIT-AE-App-Svelte/README_guidelines.md

One Sky IT's Aether App - UI and UX Guidelines and Rules

General

Events

layout header

layout footer

Journals

buttons

alert

info

priority, flag

warning, hide

variant-soft-warning hover:variant-filled-warning

error, delete, disable

variant-soft-error hover:variant-filled-error

new root layout header

submenu

flex flex-row items-center justify-center gap-1

new layout footer

Svelte 5 and SvelteKit v2 (framework and routing)

Tailwind 3.x CSS (styles)

Waiting to upgrade to 4.x when ShadCN is ready. ShadCN is still being worked on as of late March 2025.

• https://ui.shadcn.com/docs/tailwind-v4

ShadCN (Tailwind Components)

• https://ui.shadcn.com/docs
• https://github.com/shadcn-ui/ui

Skeleton (Design System, Tailwind Components, Functional Components)

Waiting to upgrade to Skeleton v3. Mostly because of the Tailwind 4.x upgrade needed for ShadCN.

• https://www.skeleton.dev/docs/get-started/migrate-from-v2

Flowbite (Tailwind Components)

Lucide Icons (SVG Icons)

• https://lucide.dev/icons/

Markdown

Using marked for Markdown parsing.

• https://marked.js.org/

Edra (TipTap based Rich Text Editor)

• https://edra.tsuzat.com/