sdga-ui 1.0.0

package/.editorconfig

@@ -0,0 +1,23 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+trim_trailing_whitespace = true
+
+# Matches multiple files with brace expansion notation
+[*.{js,jsx,ts,tsx,json,css,scss,md,html,yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+[Makefile]
+indent_style = tab

package/.prettierignore

@@ -0,0 +1,73 @@
+# Dependencies
+node_modules
+bower_components
+
+# Production builds
+dist
+build
+out
+.next
+.nuxt
+.cache
+.parcel-cache
+
+# Package files
+*.min.js
+*.min.css
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Coverage and test reports
+coverage
+.nyc_output
+*.lcov
+
+# Environment and config
+.env
+.env.local
+.env.*.local
+
+# Git
+.git
+.gitignore
+
+# IDE and editors
+.vscode
+.idea
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Documentation
+CHANGELOG.md
+LICENSE
+
+# Generated files
+*.generated.*
+*.bundle.*
+
+# Assets
+*.png
+*.jpg
+*.jpeg
+*.gif
+*.svg
+*.ico
+*.pdf
+*.woff
+*.woff2
+*.ttf
+*.eot
+*.otf

package/.prettierrc

@@ -0,0 +1,17 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "avoid",
+  "bracketSpacing": true,
+  "endOfLine": "lf",
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": false,
+  "bracketSameLine": false,
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "embeddedLanguageFormatting": "auto"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mahmoud Adel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# **DGA UI – Government-Style Bootstrap Theme**
+
+**DGA UI** is a customizable UI theme inspired by modern government and authority design systems.
+Built on top of **Bootstrap**, it provides consistent colors, typography, spacing, and reusable UI patterns suitable for official portals, administrative dashboards, and public-sector applications.
+
+This package helps you apply a clean, structured, and authoritative look across your web interfaces with minimal setup.
+
+---
+
+## **✨ Features**
+
+* Government-inspired design system
+* Full compatibility with Bootstrap
+* Custom color palette and typography
+* Standardized spacing & component overrides
+* Utility classes for layout and theming
+* Light / dark mode friendly (optional)
+* Easy to integrate into any frontend project
+
+---
+
+## **📦 Installation**
+
+Install via npm:
+
+```bash
+npm install dga-ui
+```
+
+Or with yarn:
+
+```bash
+yarn add dga-ui
+```
+
+---
+
+## **🔧 Usage**
+
+### **Using the Compiled CSS**
+
+Include the compiled CSS file in your HTML:
+
+```html
+<link rel="stylesheet" href="node_modules/dga-ui/css/dga-ui.css">
+```
+
+Or import it in your JavaScript/CSS:
+
+```css
+@import "dga-ui/css/dga-ui.css";
+```
+
+### **Using SCSS Source Files**
+
+Import the theme in your SCSS file:
+
+```scss
+@import "dga-ui/theme/dga-ui";
+```
+
+All Bootstrap components automatically adopt the DGA UI theme.
+
+---
+
+## **📁 File Structure**
+
+```
+dga-ui/
+│
+├─ css/                 # Compiled CSS output
+│  └─ dga-ui.css
+├─ fonts/               # Font files (IBM Plex Sans Arabic)
+├─ theme/               # Source SCSS theme files
+│  ├─ dga-ui.scss       # Main theme entry point
+│  ├─ _fonts.scss
+│  ├─ _functions.scss
+│  ├─ _variables.scss
+│  ├─ config/           # Base configuration
+│  ├─ components/       # Component styles
+│  └─ customizations/   # Theme customizations
+├─ package.json
+├─ LICENSE
+└─ README.md
+```
+
+---
+
+## **🛠 Development**
+
+### **Building the CSS**
+
+Compile the SCSS to CSS:
+
+```bash
+npm run build-css
+```
+
+### **Watch Mode**
+
+Watch for changes and auto-compile:
+
+```bash
+npm run watch-css
+```
+
+### **Customization**
+
+You can override SCSS variables before importing the theme:
+
+```scss
+// Your custom variables
+$primary: #0d47a1;
+$secondary: #ffc107;
+
+// Import the DGA UI theme
+@import "dga-ui/theme/dga-ui";
+```
+
+---
+
+## **🎨 Theme Structure**
+
+The theme is organized into three main sections:
+
+- **config/** - Base configuration (colors, typography, spacing, etc.)
+- **components/** - Bootstrap component overrides
+- **customizations/** - Additional styling and utilities
+
+---
+
+## **📚 Roadmap**
+
+* React / Angular UI components
+* Icon set
+* Forms enhancement
+* Grid templates
+* Additional themes (municipal, ministry, authority variants)
+
+---
+
+## **🤝 Contributing**
+
+Contributions are welcome!
+Feel free to open issues, submit pull requests, or suggest improvements.
+
+---
+
+## **📄 License**
+
+MIT License — free for personal and commercial use.
+
+---
+
+## **👤 Author**
+
+Created and maintained by **Mahmoud**.
+
+---
+
+If you want, I can also generate:
+
+✅ A logo
+✅ A color palette for the authority theme
+✅ Example screenshots/mockups
+✅ NPM keywords
+Just tell me!