appclean 1.8.0

package/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create Release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+          body: |
+            Published to npm registry
+          draft: false
+          prerelease: false

package/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node-version: [16.x, 18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        if: matrix.os == 'ubuntu-latest' && matrix.node-version == '18.x'

package/ACTION_CHECKLIST.md

@@ -0,0 +1,342 @@
+# AppClean Marketing & Launch Checklist
+
+## 🎯 Priority Matrix: Highest ROI First
+
+### 🔴 CRITICAL (Do This Week) - Highest Impact
+
+- [ ] **Submit to Show HN** (Est. 500-2000 upvotes, 100k+ impressions)
+  - Link: https://news.ycombinator.com/submit
+  - Time: 15 minutes
+  - Copy: Use COMMUNITY_POSTS.md > Show HN Submission
+  - Best time: Tuesday-Thursday 8-10 AM PT
+  - Expected outcome: Top 30 of HN, 200-500 GitHub stars
+
+- [ ] **Post to r/commandline** (Est. 50-100 stars, high engagement)
+  - Link: https://reddit.com/r/commandline
+  - Time: 10 minutes
+  - Copy: Use COMMUNITY_POSTS.md > Reddit r/commandline
+  - Expected: 500-2000 upvotes, 50+ comments
+
+- [ ] **Post npm install one-liner on Twitter/X** (Est. 100-500 clicks)
+  - Tweet: "npm install -g appclean" + problem description
+  - Time: 5 minutes
+  - Copy: Use COMMUNITY_POSTS.md > Twitter/X One-Liner
+  - Tags: #devtools #cli #nodejs #opensource
+  - Expected: 50-200 retweets, 200-500 clicks
+
+---
+
+### 🟡 HIGH PRIORITY (Do This Week) - Major Impact
+
+- [ ] **Post to r/linux** (Est. 30-50 stars, high quality users)
+  - Link: https://reddit.com/r/linux
+  - Time: 10 minutes
+  - Copy: Use COMMUNITY_POSTS.md > Reddit r/linux
+
+- [ ] **Post to r/node** (Est. 20-30 stars, npm developers)
+  - Link: https://reddit.com/r/node
+  - Time: 10 minutes
+  - Copy: Use COMMUNITY_POSTS.md > Reddit r/node
+
+- [ ] **Post to r/opensource** (Est. 20-40 stars, community engagement)
+  - Link: https://reddit.com/r/opensource
+  - Time: 10 minutes
+  - Copy: Use COMMUNITY_POSTS.md > Reddit r/opensource
+
+- [ ] **Enable GitHub Discussions** (Community engagement infrastructure)
+  - Time: 5 minutes
+  - Go to Settings → General → Features → Enable Discussions
+  - Create 5 category channels
+
+- [ ] **Create GitHub Discussions Channels** (Est. 10 members/week)
+  - Announcements
+  - Q&A
+  - Ideas
+  - Show & Tell
+  - Troubleshooting
+  - Time: 10 minutes
+
+- [ ] **Pin Initial Discussions Post** (Welcome message)
+  - Announcement: "AppClean v1.8.0 Released"
+  - Time: 5 minutes
+
+---
+
+### 🟠 MEDIUM PRIORITY (Do This Month) - Moderate Impact
+
+- [ ] **Create GitHub Topics Social Preview Image** (Better shareability)
+  - Dimensions: 1200 x 630 px
+  - Include: Logo, tagline, problem statement
+  - Time: 20-30 minutes
+  - Tool: Figma, Canva, or GitHub Copilot Image Generator
+  - Expected: 10-20% improvement in social click-through
+
+- [ ] **Add CONTRIBUTING.md** (Community framework)
+  - Time: 15 minutes
+  - Copy: Use GITHUB_OPTIMIZATION.md template
+
+- [ ] **Add CODE_OF_CONDUCT.md** (Professional standards)
+  - Time: 10 minutes
+  - Copy: Use GITHUB_OPTIMIZATION.md template
+
+- [ ] **Add SECURITY.md** (Trust & transparency)
+  - Time: 10 minutes
+  - Copy: Use GITHUB_OPTIMIZATION.md template
+
+- [ ] **Post to Dev.to** (Est. 20-50 stars, developer community)
+  - Link: https://dev.to/new
+  - Time: 30 minutes
+  - Content: Blog post from DEV_TO_TEMPLATE.md
+  - Expected: 500-1000 reads, 20-50 stars
+
+- [ ] **Submit to Awesome Lists** (Long-term discoverability)
+  - Time: 15 minutes per list
+  - Lists:
+    - https://github.com/agarrharr/awesome-cli-apps
+    - https://github.com/sindresorhus/awesome-nodejs
+    - https://github.com/awesome-sh/awesome-shell
+
+- [ ] **Post npm badge to Twitter** (Package promotion)
+  - Tweet: "AppClean is now on npm!"
+  - Include: npm install badge
+  - Time: 5 minutes
+
+---
+
+### 🟢 NICE TO HAVE (Do This Month) - Building Blocks
+
+- [ ] **Create GitHub Pages Site** (Long-term marketing asset)
+  - Setup docs/ folder
+  - Create landing page
+  - Time: 1-2 hours
+  - Tools: GitHub Pages + Jekyll or static HTML
+
+- [ ] **Set up GitHub Actions CI/CD** (Professional credibility)
+  - Create test workflow
+  - Create publish workflow
+  - Time: 30 minutes
+
+- [ ] **Create GitHub Actions Badge** (Shows maintenance)
+  - Add to README
+  - Time: 5 minutes
+
+- [ ] **Create Dependabot Setup** (Security credibility)
+  - Enable in Settings
+  - Configure schedule
+  - Time: 10 minutes
+
+- [ ] **Add Code Climate / Quality Badge** (Code quality signal)
+  - Link: https://codeclimate.com/
+  - Time: 15 minutes
+
+- [ ] **Pin AppClean on Your GitHub Profile** (Personal branding)
+  - Go to profile
+  - Pin repository
+  - Time: 2 minutes
+
+- [ ] **Create GitHub Release Assets** (Professional distribution)
+  - Pre-built binaries for macOS/Linux/Windows
+  - Time: 1 hour
+  - Expected: Easier installation for non-npm users
+
+---
+
+### 💡 COMMUNITY ENGAGEMENT (Ongoing)
+
+- [ ] **Respond to GitHub Issues** (Community management)
+  - Target: 24-hour response time
+  - Engagement rate: Aim for 80%+ resolution
+
+- [ ] **Engage with Discussions** (Community building)
+  - Frequency: Daily
+  - Goal: Create 3-5 discussion posts/week
+
+- [ ] **Share Community Wins** (Engagement)
+  - When: User does something cool with AppClean
+  - Where: Twitter, GitHub Discussions
+  - Frequency: 1-2x/month
+
+- [ ] **Share Usage Tips** (Education)
+  - Weekly tips on Twitter
+  - Biweekly tutorials in Discussions
+  - Monthly blog posts on Dev.to
+
+- [ ] **Ask for Feedback** (Community input)
+  - Monthly poll on what features matter most
+  - Quarterly survey on usability
+
+---
+
+## 📊 Expected Results Timeline
+
+### Week 1-2 (After Critical Tasks)
+- Show HN submission: 200-500 stars
+- Reddit posts: 100-200 stars total
+- Twitter: 500-1000 clicks
+- Discussion engagement: 20-50 members
+
+**Expected Total: 300-700 new GitHub stars**
+
+### Month 1
+- GitHub Discussions: 100+ members
+- npm downloads: 200-500/week
+- Blog mentions: 5-10 new mentions
+- Awesome lists: Accepted to 2-3 lists
+
+**Expected Total: 500-1000 new GitHub stars**
+
+### Month 3
+- Total stars: 1000-2000
+- Monthly npm downloads: 1000-2000
+- Active discussions: 50+ topics
+- Community contributors: 3-5
+
+---
+
+## 🚀 Quick Wins (Complete in 30 Minutes)
+
+```bash
+# 1. Submit to Show HN (10 min)
+# Copy title and text from COMMUNITY_POSTS.md
+# Visit https://news.ycombinator.com/submit
+# Submit!
+
+# 2. Tweet one-liner (5 min)
+# Copy from COMMUNITY_POSTS.md > Twitter/X
+# Post on Twitter/X with #devtools #cli #nodejs
+
+# 3. Post to r/commandline (10 min)
+# Copy from COMMUNITY_POSTS.md > Reddit r/commandline
+# Post to https://reddit.com/r/commandline
+
+# 4. Enable GitHub Discussions (5 min)
+# Go to Settings → General → Features → Check Discussions
+# Save changes
+
+# 5. Create first discussion (2 min)
+# Announcements category
+# Title: "AppClean v1.8.0 Released!"
+# Post!
+
+# Total time: ~32 minutes
+# Expected impact: 500+ GitHub stars + 1000+ npm downloads/week
+```
+
+---
+
+## 📈 Metrics to Track
+
+### GitHub
+- ⭐ Stars (target: 50/week from marketing)
+- 👥 Forks
+- 👀 Watchers
+- 📊 Traffic
+- 💬 Discussions
+- 🐛 Issues (quality of reports)
+
+### npm
+- 📦 Weekly downloads (target: +500/week)
+- 🌟 Package rating
+- 🔗 Dependents
+
+### Social Media
+- 🐦 Twitter impressions
+- 👍 Reddit upvotes
+- 💬 Reddit comments
+- 🔄 Shares/retweets
+
+### Website/Blog
+- 👁️ Page views
+- ⏱️ Avg. time on page
+- 🔗 Clicks to GitHub/npm
+
+---
+
+## 📅 Timeline
+
+### This Week (Days 1-7)
+- [ ] Show HN submit
+- [ ] Reddit posts (4)
+- [ ] Twitter one-liner
+- [ ] GitHub Discussions setup
+- [ ] First discussion post
+
+**Expected**: 300-500 stars, 2000-3000 npm downloads
+
+### Week 2
+- [ ] Dev.to blog post
+- [ ] Awesome list submissions
+- [ ] Community engagement
+- [ ] First community responses
+
+**Expected**: 500-700 stars total, 2000-2500 npm downloads/week
+
+### Month 1
+- [ ] GitHub optimizations complete
+- [ ] CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md
+- [ ] GitHub Pages site (optional)
+- [ ] Regular engagement
+
+**Expected**: 700-1000 stars, 3000-4000 npm downloads/week
+
+---
+
+## 🎁 Bonus Ideas
+
+### Cross-promotion
+- Link from npm package → GitHub
+- Link from GitHub README → npm
+- Link from each → Twitter
+
+### Affiliate/Sponsorship (Future)
+- GitHub Sponsors
+- Patreon (if community grows)
+- Ko-fi donations
+
+### Content Ideas
+- YouTube tutorial (2-3 min demo)
+- Podcast guest appearance
+- Blog post on dev.to/medium
+- Tutorial video series
+
+### Community Ideas
+- Create Slack/Discord community
+- Monthly newsletter
+- Example plugin plugins
+- Community showcase
+
+---
+
+## 🏆 Success Criteria
+
+### Month 1
+- ✅ 500+ GitHub stars
+- ✅ 50+ GitHub Discussions
+- ✅ 3000+ npm downloads/week
+- ✅ 10+ awesome list adds
+- ✅ 50+ Twitter followers mention
+
+### Month 3
+- ✅ 1000+ GitHub stars
+- ✅ 200+ Discussion members
+- ✅ 5000+ npm downloads/week
+- ✅ 3-5 community contributors
+- ✅ Featured in 5+ dev newsletters
+
+### Month 6
+- ✅ 2000+ GitHub stars
+- ✅ 10000+ npm downloads/week
+- ✅ Active community
+- ✅ Regular releases
+- ✅ Sustainable growth
+
+---
+
+## Notes
+
+- All Reddit posts should use same problem-first approach
+- Don't spam – space posts out by 2-3 days
+- Engage authentically in comments
+- Link to GitHub (not npm directly) in posts
+- Ask for feedback in all posts
+- Thank people who help/share