debe/desktop-standard
Watch
1
0
Fork
You've already forked desktop-standard
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
المعيار الموحّد لتطبيقات الديسكتوب — الثيم والهيكلة وسير العمل | The unified standard for desktop apps: theme, structure, workflow
15 commits 1 branch 12 tags 219 KiB
  • TypeScript 34.6%
  • JavaScript 29.5%
  • CSS 20%
  • HTML 15.9%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
balnaimi 5974c738dd chore(release): v1.7.2 — ship AGENTS.md with scaffolded apps
2026-09-09 20:16:40 +03:00
CI feat(standard): add typecheck CI, lint/format, component test, checksum, editorconfig, cross-platform, gallery, shared i18n 2026-09-08 05:01:25 +03:00
scripts feat(license): switch from MIT to CC BY-NC-SA 4.0 (non-commercial + share-alike) 2026-09-08 04:52:01 +03:00
TEMPLATE feat(template): add AGENTS.md pointer so scaffolded apps auto-follow the standard 2026-09-08 07:36:54 +03:00
.gitignore chore: initial desktop-standard — docs, theme spec, and React electron-vite template 2026-09-07 16:53:25 +03:00
AGENTS.md feat(standard): public-repo hygiene rule and author identity balnaimi <doha.os@balnaimi.com> 2026-09-08 04:46:06 +03:00
CHANGELOG.md chore(release): v1.7.2 — ship AGENTS.md with scaffolded apps 2026-09-09 20:16:40 +03:00
LICENSE feat(license): switch from MIT to CC BY-NC-SA 4.0 (non-commercial + share-alike) 2026-09-08 04:52:01 +03:00
MIGRATION.md chore: initial desktop-standard — docs, theme spec, and React electron-vite template 2026-09-07 16:53:25 +03:00
package.json chore(release): v1.7.2 — ship AGENTS.md with scaffolded apps 2026-09-09 20:16:40 +03:00
preview.html feat(standard): add typecheck CI, lint/format, component test, checksum, editorconfig, cross-platform, gallery, shared i18n 2026-09-08 05:01:25 +03:00
README.md feat: single source of colors, version the standard, and add release automation 2026-09-07 19:21:27 +03:00
STANDARD.md docs(standard): clarify scope is desktop-only; server apps get a separate standard later 2026-09-08 05:36:07 +03:00
THEME.md feat(window): make window resizable by default (default 1200x780, min 800x560) 2026-09-08 03:29:00 +03:00
theme.tokens.json feat: single source of colors, version the standard, and add release automation 2026-09-07 19:21:27 +03:00
WORKFLOW.md feat(standard): add typecheck CI, lint/format, component test, checksum, editorconfig, cross-platform, gallery, shared i18n 2026-09-08 05:01:25 +03:00

README.md

desktop-standard

المعيار الموحّد لكل تطبيقات الديسكتوب تحت حساب debe — الثيم، الهيكلة، وسير العمل.

The single standard for every desktop app under the debe account — theme, structure, and workflow.

للايجنت (اقرأني أولًا): قبل إنشاء أو تعديل أي تطبيق ديسكتوب، اقرأ STANDARD.md ثم THEME.md. For the agent (read me first): before creating or modifying any desktop app, read STANDARD.md then THEME.md.

المحتويات / Contents

ملف / File الغرض / Purpose
STANDARD.md القواعد الإلزامية: الستاك، الهيكلة، الشل، التسمية، الإصدارات، CI. The mandatory rules.
THEME.md مواصفات الثيم الكاملة (الألوان + المكونات + RTL). The complete theme spec.
WORKFLOW.md سير العمل من الإنشاء حتى الإصدار. The end-to-end workflow.
MIGRATION.md دليل ترحيل التطبيقات القديمة للستاندر (اختياري). Optional migration guide.
CI/ نسخ test.yml + release.yml الموحّدة. Canonical CI workflows.
TEMPLATE/ سقالة جاهزة للنسخ لأي تطبيق جديد. Copyable scaffold.
AGENTS.md تعليمات الأيجنت (تُقرأ تلقائيًا). Agent auto-read instructions.
scripts/new-app.mjs توليد تطبيق جديد بأمر واحد. One-command scaffolder.
scripts/check-standard.mjs فاحص الالتزام بالستاندر. Compliance checker.
theme.tokens.json مصدر الألوان الوحيد. Single source of colors.
scripts/gen-theme.mjs توليد الثيم من الـ tokens. Theme generator.
preview.html معاينة مرئية للثيم في المتصفح. Visual theme preview.

كيف تبدأ تطبيق جديد؟ / How to start a new app?

node scripts/new-app.mjs my-app "وصف التطبيق"

ينسخ القالب، يستبدل كل الرموز، يضيف CI، يهيّئ git، ينشئ الريبو ويرفعه — بأمر واحد.

node scripts/check-standard.mjs /path/to/app   # فحص الالتزام بالستاندر

التفاصيل في WORKFLOW.md.

الثيم باختصار / The theme in one line

رمادي دافئ + عنّابي #8b153d + ذهبي #8f6a2a + ألوان حالة — بخط Tajawal مضمّن، RTL/LTR، فاتح/داكن.

Warm gray + maroon #8b153d + gold #8f6a2a + status colors — embedded Tajawal font, RTL/LTR, light/dark.