Merge branch 'feature/contribution-experience'

Author: PixelCode01

.github/ISSUE_TEMPLATE/config.yml

@@ -1,11 +1,11 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
-  - name: 💬 General Discussion
+  - name: General Discussion
     url: https://github.com/PixelCode01/UIBloatwareRegistry/discussions
     about: Ask questions and discuss with the community
-  - name: 📚 Documentation
+  - name: Documentation
     url: https://github.com/PixelCode01/UIBloatwareRegistry/blob/main/README.md
     about: Read the documentation and usage guides
-  - name: 🤝 Contributing Guide
+  - name: Contributing Guide
     url: https://github.com/PixelCode01/UIBloatwareRegistry/blob/main/CONTRIBUTING.md
     about: Learn how to contribute to the project

.github/ISSUE_TEMPLATE/new_package_entry.yml

@@ -1,4 +1,4 @@
-name: 🆕 New Package Entry
+name: New Package Entry
 description: Submit a new bloatware package to add to the registry
 title: "[NEW PACKAGE]: "
 labels: ["enhancement", "new-package"]
@@ -82,10 +82,10 @@ body:
       label: Risk Level
       description: How safe is it to remove this package?
       options:
-        - 🟢 Safe - No system functionality affected
-        - 🟡 Caution - May affect some functionality
-        - 🔴 Dangerous - May cause system instability
-        - ⚪ Unknown - Needs more testing
+        - Safe - No system functionality affected
+        - Caution - May affect some functionality
+        - Dangerous - May cause system instability
+        - Unknown - Needs more testing
     validations:
       required: true
 
@@ -114,11 +114,11 @@ body:
         **Testing Method:** Removed via ADB (pm uninstall --user 0)
         
         **Tests Performed:**
-        - Basic phone functions: ✅ Working
+        - Basic phone functions: Working
         - Affected features: Bixby not launching (expected)
-        - System stability: ✅ No issues
-        - Boot time: ✅ Normal
-        - Other apps: ✅ No crashes
+        - System stability: No issues
+        - Boot time: Normal
+        - Other apps: No crashes
         
         **Recovery Tested:** Yes, successfully reinstalled with cmd package install-existing
     validations:

.github/ISSUE_TEMPLATE/removal_problem_report.yml

@@ -1,4 +1,4 @@
-name: 🐛 Removal Problem Report
+name: Removal Problem Report
 description: Report issues encountered when removing a specific package
 title: "[REMOVAL ISSUE]: "
 labels: ["bug", "removal-issue"]
@@ -68,10 +68,10 @@ body:
       label: Issue Severity
       description: How severe is the problem?
       options:
-        - 🔴 Critical - Device won't boot or major functionality lost
-        - 🟠 High - Important features broken but device usable
-        - 🟡 Medium - Minor features affected
-        - 🟢 Low - Cosmetic or very minor issues
+        - Critical - Device won't boot or major functionality lost
+        - High - Important features broken but device usable
+        - Medium - Minor features affected
+        - Low - Cosmetic or very minor issues
     validations:
       required: true
 

.github/ISSUE_TEMPLATE/update_risk_level.yml

@@ -1,4 +1,4 @@
-name: 🔄 Update Risk Level
+name: Update Risk Level
 description: Report incorrect risk level or suggest an update based on new testing
 title: "[RISK UPDATE]: "
 labels: ["risk-update", "needs-review"]
@@ -50,10 +50,10 @@ body:
       label: Current Risk Level
       description: What is the current risk level in the registry?
       options:
-        - 🟢 Safe
-        - 🟡 Caution
-        - 🔴 Dangerous
-        - ⚪ Unknown
+        - Safe
+        - Caution
+        - Dangerous
+        - Unknown
     validations:
       required: true
 
@@ -63,10 +63,10 @@ body:
       label: Proposed Risk Level
       description: What should the risk level be changed to?
       options:
-        - 🟢 Safe
-        - 🟡 Caution
-        - 🔴 Dangerous
-        - ⚪ Unknown
+        - Safe
+        - Caution
+        - Dangerous
+        - Unknown
     validations:
       required: true
 

.github/pull_request_template.md

@@ -8,14 +8,14 @@
 
 <!-- Check all that apply -->
 
-- [ ] 🆕 New package(s) added
-- [ ] 🔄 Updated existing package(s)
-- [ ] 🗑️ Removed deprecated package(s)
-- [ ] 🔧 Bug fix (non-breaking change which fixes an issue)
-- [ ] ✨ New feature (non-breaking change which adds functionality)
-- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
-- [ ] 📚 Documentation update
-- [ ] 🎨 Code style/formatting changes
+- [ ] New package(s) added
+- [ ] Updated existing package(s)
+- [ ] Removed deprecated package(s)
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code style/formatting changes
 
 ## Changes Made
 
@@ -52,14 +52,14 @@
 
 <!-- Check all that apply -->
 
-- [ ] ✅ Tested on actual device
-- [ ] ✅ Used test mode to verify
-- [ ] ✅ Package removal successful
-- [ ] ✅ No system instability observed
-- [ ] ✅ Affected features documented
-- [ ] ✅ Recovery/restoration tested
-- [ ] ⚠️ Found issues (documented below)
-- [ ] ❌ Not tested yet (explain why)
+- [ ] Tested on actual device
+- [ ] Used test mode to verify
+- [ ] Package removal successful
+- [ ] No system instability observed
+- [ ] Affected features documented
+- [ ] Recovery/restoration tested
+- [ ] Found issues (documented below)
+- [ ] Not tested yet (explain why)
 
 ### Issues Encountered
 

.github/workflows/gh-pages.yml

@@ -28,23 +28,61 @@ jobs:
           python-version: "3.11"
 
       - name: Generate dataset
-        run: python scripts/generate_data_bundle.py --out build/data.json --public web/public/data.json
+        run: |
+          mkdir -p build web/public
+          python scripts/generate_data_bundle.py --out build/data.json --public web/public/data.json || true
+
+      - name: Check if web directory exists
+        id: check_web
+        run: |
+          if [ -d "web" ] && [ -f "web/package.json" ]; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
 
       - name: Set up Node.js
+        if: steps.check_web.outputs.exists == 'true'
         uses: actions/setup-node@v4
         with:
           node-version: "20"
           cache: "npm"
           cache-dependency-path: web/package-lock.json
 
       - name: Install dependencies
+        if: steps.check_web.outputs.exists == 'true'
         working-directory: web
         run: npm install
 
       - name: Build site
+        if: steps.check_web.outputs.exists == 'true'
         working-directory: web
         run: npm run build
 
+      - name: Create placeholder page
+        if: steps.check_web.outputs.exists == 'false'
+        run: |
+          mkdir -p web/dist
+          cat > web/dist/index.html << 'EOF'
+          <!DOCTYPE html>
+          <html>
+          <head>
+            <title>UIBloatwareRegistry Explorer - Coming Soon</title>
+            <style>
+              body { font-family: system-ui; max-width: 800px; margin: 50px auto; padding: 20px; }
+              h1 { color: #333; }
+              p { line-height: 1.6; color: #666; }
+              a { color: #0066cc; }
+            </style>
+          </head>
+          <body>
+            <h1>UIBloatwareRegistry Explorer</h1>
+            <p>The web interface is currently under development.</p>
+            <p>Visit the <a href="https://github.com/PixelCode01/UIBloatwareRegistry">GitHub repository</a> for the command-line tool.</p>
+          </body>
+          </html>
+          EOF
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
@@ -53,6 +91,9 @@ jobs:
   deploy:
     needs: build
     runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}

CONTRIBUTING.md

@@ -58,14 +58,14 @@ adb shell pm path <package.name>
 
 ### Safety Checklist
 
-✅ **DO identify packages that are:**
+**DO identify packages that are:**
 - Manufacturer-specific apps you don't use
 - Carrier-installed apps
 - Duplicate apps (when alternatives are available)
 - Promotional or shopping apps
 - OEM assistants you don't use
 
-❌ **DO NOT identify packages that are:**
+**DO NOT identify packages that are:**
 - Core system services
 - Android framework components
 - Google Play Services (unless you know what you're doing)
@@ -109,7 +109,7 @@ adb shell pm path <package.name>
 
 Choose the appropriate risk level for each package:
 
-### 🟢 Safe
+### Safe
 **Definition**: Can be removed without affecting system functionality
 
 **Criteria**:
@@ -123,7 +123,7 @@ Choose the appropriate risk level for each package:
 - `com.amazon.mShop.android.shopping` - Amazon Shopping
 - `com.netflix.mediaclient` - Netflix (pre-installed)
 
-### 🟡 Caution
+### Caution
 **Definition**: May affect some functionality, but system remains stable
 
 **Criteria**:
@@ -136,7 +136,7 @@ Choose the appropriate risk level for each package:
 - `com.samsung.android.messaging` - Samsung Messages
 - `com.google.android.apps.maps` - Google Maps
 
-### 🔴 Dangerous
+### Dangerous
 **Definition**: May cause system instability, boot loops, or critical feature loss
 
 **Criteria**:
@@ -151,7 +151,7 @@ Choose the appropriate risk level for each package:
 - `com.google.android.gms` - Google Play Services
 - `com.android.systemui` - System UI
 
-### ⚫ Unknown
+### Unknown
 **Definition**: Not yet tested or categorized
 
 **Usage**: Temporary classification until proper testing is done

CONTRIBUTION_GUIDE.md

@@ -6,15 +6,15 @@ The new contribution system simplifies adding bloatware packages to the registry
 
 ## What's New?
 
-### ✅ Before (Old System)
+### Before (Old System)
 To add a new package, you needed to:
 1. Edit the brand's Python file (`Samsung/samsung_remover.py`)
 2. Edit the brand's Shell script (`Samsung/samsung_remover.sh`)
 3. Edit the brand's Markdown file (`Samsung/samsung-bloatware-list.md`)
 4. Ensure consistency across all three files
 5. Know Python, Shell, and Markdown syntax
 
-### 🎉 After (New System)
+### After (New System)
 Now you can:
 1. Run `python contribute.py` (interactive tool)
 2. OR edit `packages_registry.json` directly
@@ -85,46 +85,46 @@ Edit `packages_registry.json` directly:
 ### New System
 ```
 UIBloatwareRegistry/
-├── packages_registry.json      # ⭐ Single source of truth
-├── contribute.py               # ⭐ Contribution tool
+├── packages_registry.json      # Single source of truth
+├── contribute.py               # Contribution tool
 ├── core/
-│   └── package_registry.py     # ⭐ Registry manager
+│   └── package_registry.py     # Registry manager
 ├── .github/
-│   ├── ISSUE_TEMPLATE/         # ⭐ Issue templates
+│   ├── ISSUE_TEMPLATE/         # Issue templates
 │   │   ├── new_package_entry.yml
 │   │   ├── update_risk_level.yml
 │   │   └── removal_problem_report.yml
-│   └── pull_request_template.md # ⭐ PR template
-└── CONTRIBUTING.md             # ⭐ Enhanced guidelines
+│   └── pull_request_template.md # PR template
+└── CONTRIBUTING.md             # Enhanced guidelines
 ```
 
 ### Old System (Deprecated)
 ```
 UIBloatwareRegistry/
 ├── Samsung/
-│   ├── samsung_remover.py      # ⚠️ Will use registry
-│   ├── samsung_remover.sh      # ⚠️ May be deprecated
-│   └── samsung-bloatware-list.md # ⚠️ Generated from registry
+│   ├── samsung_remover.py      # Will use registry
+│   ├── samsung_remover.sh      # May be deprecated
+│   └── samsung-bloatware-list.md # Generated from registry
 ```
 
 ## Risk Level Guidelines
 
-### 🟢 SAFE
+### SAFE
 - No system functionality affected
 - Can be removed without concerns
 - Examples: Bixby, Samsung Cloud, carrier apps
 
-### 🟡 CAUTION
+### CAUTION
 - May affect some functionality
 - Remove only if you don't use it
 - Examples: Default SMS app, Browser
 
-### 🔴 DANGEROUS
+### DANGEROUS
 - May cause system instability
 - NOT recommended for average users
 - Examples: Google Play Services, System launcher
 
-### ⚪ UNKNOWN
+### UNKNOWN
 - Not yet tested or categorized
 - Research before removing
 - Treat as DANGEROUS until proven otherwise
@@ -169,14 +169,14 @@ python contribute.py
 ```
 
 Features:
-- ✅ Add new packages
-- ✅ Update existing packages
-- ✅ Remove packages
-- ✅ Search packages
-- ✅ View brands and categories
-- ✅ Risk level guidelines
-- ✅ Input validation
-- ✅ Duplicate detection
+- Add new packages
+- Update existing packages
+- Remove packages
+- Search packages
+- View brands and categories
+- Risk level guidelines
+- Input validation
+- Duplicate detection
 
 ### CLI Mode
 ```bash
@@ -303,10 +303,10 @@ A: Git version control keeps everything safe. Just submit a correction PR!
 
 ## Support
 
-- 📖 Read [CONTRIBUTING.md](../CONTRIBUTING.md)
-- 💬 Start a [Discussion](https://github.com/PixelCode01/UIBloatwareRegistry/discussions)
-- 🐛 Report an [Issue](https://github.com/PixelCode01/UIBloatwareRegistry/issues)
+- Read [CONTRIBUTING.md](../CONTRIBUTING.md)
+- Start a [Discussion](https://github.com/PixelCode01/UIBloatwareRegistry/discussions)
+- Report an [Issue](https://github.com/PixelCode01/UIBloatwareRegistry/issues)
 
 ---
 
-**Happy Contributing! 🎉**
+**Happy Contributing!**