@jairodri/huckleberry-cli 1.0.2 → 1.1.0

package/skills/startup-launcher/references/platforms/stacksocial.md

@@ -0,0 +1,244 @@
+# StackSocial Platform Guide
+
+*Last Updated: March 2026*
+
+## 1. Platform Overview
+
+StackSocial is a daily deals e-commerce platform owned and operated by StackCommerce (founded as StackSocial in 2011, rebranded in 2014). Founded by Josh Payne in Venice, California, StackSocial positions itself as "The Hottest Tech Deals, Delivered Daily" and specializes in curated technology deals, software bundles, online courses, and lifetime subscriptions.
+
+- **URL**: https://stacksocial.com
+- **Parent Company**: StackCommerce (StackSocial, Inc.)
+- **Founded**: 2011
+- **Category**: Daily deals marketplace / Product discovery platform
+- **Focus**: Software, apps, digital tools, online courses, electronics, gadgets, and lifetime deals
+
+StackCommerce operates as a product discovery platform that helps publishers monetize their sites while connecting brands with relevant audiences. StackSocial is their direct-to-consumer marketplace.
+
+## 2. Key Stats
+
+- **Revenue**: Estimated $80M+ annually (as of 2021)
+- **Traffic**: ~1.45M monthly sessions
+- **Transactions**: ~49K monthly transactions 
+- **Average Order Value**: ~$174 (calculated from revenue/transactions)
+- **Domain Rating**: Strong e-commerce presence since 2011
+- **Target Audience**: Tech-savvy consumers looking for software deals and digital products
+- **Pricing Model**: Custom pricing for vendors based on requirements (no transparent pricing)
+
+**Note**: Traffic and transaction data sourced from Grips Intelligence estimates; actual figures may vary.
+
+## 3. Who Should Use This
+
+**Ideal Product Types:**
+- Software applications (productivity, security, utilities, design)
+- Online courses and educational content
+- Digital tools and SaaS products
+- Lifetime subscription offerings
+- Tech gadgets and electronics
+- Mobile apps
+- Digital subscriptions and memberships
+
+**Best Fit For:**
+- Software companies looking to liquidate inventory or older versions
+- Course creators with evergreen content
+- SaaS startups needing user acquisition
+- Companies comfortable with heavy discounting (50-90% off MSRP)
+- Businesses seeking exposure through lifetime deal marketing
+
+**Not Ideal For:**
+- Physical products requiring complex shipping
+- High-margin luxury items
+- Products that can't sustain deep discounts
+- Businesses unable to honor lifetime commitments
+
+## 4. Submission Process
+
+**Important Note**: StackCommerce uses an invitation/partnership model rather than open submissions. The exact submission process is not publicly documented, suggesting they curate vendors through:
+
+1. **Direct Outreach**: StackCommerce likely identifies and approaches potential vendors
+2. **Partnership Inquiries**: Contact through their business development channels
+3. **Referrals**: Through existing vendor networks
+4. **Industry Connections**: Via conferences, trade shows, and tech industry networking
+
+**Suggested Approach:**
+1. Research StackCommerce business development contacts on LinkedIn
+2. Prepare a compelling vendor pitch demonstrating product-market fit
+3. Submit inquiry through their corporate channels
+4. Be prepared for extensive negotiations on terms and pricing
+
+**Key Contact Points:**
+- Business Development team
+- Vendor Relations department
+- Partnership inquiries through StackCommerce corporate
+
+## 5. Requirements
+
+Based on vendor terms and platform analysis, vendors need:
+
+**Legal & Business:**
+- Valid business entity and tax identification
+- Ability to honor Reserved Quantities (exclusive inventory allocation)
+- Compliance with sales/use tax requirements in all applicable jurisdictions
+- General liability insurance
+- Ability to fulfill customer service obligations
+
+**Product Requirements:**
+- High-quality digital or physical products
+- Ability to discount significantly (50-90% off MSRP)
+- MSRP must be legitimate and reflect substantial sales (FTC compliance)
+- Products must be readily available for immediate fulfillment
+
+**Technical Assets Needed:**
+- Product logos and branding assets
+- High-quality product screenshots/images
+- Detailed product descriptions
+- Demo videos (recommended)
+- Customer testimonials and reviews
+- Technical specifications
+
+**Financial:**
+- Ability to accept StackCommerce's revenue sharing model
+- Understanding that StackCommerce retains significant portion for marketing/platform costs
+- Willingness to participate in promotional pricing adjustments
+
+## 6. Strategy & Tips
+
+**Optimal Timing:**
+- Black Friday/Cyber Monday periods show highest traffic
+- Back-to-school seasons (August-September) for educational products
+- New Year periods for productivity software
+- Avoid major product launch windows (use StackSocial for older versions)
+
+**Pricing Strategy:**
+- MSRP must be defensible and reflect real market pricing
+- Expect 70-90% discounts from MSRP
+- Factor StackCommerce's commission into your economics
+- Consider it user acquisition rather than profit center
+
+**Maximizing Visibility:**
+- Consider Featured Promotions (paid placement)
+- Provide high-quality marketing assets
+- Ensure your product fits current marketplace trends
+- Leverage StackSocial's email list and publisher network
+
+**Best Practices:**
+- Treat as customer acquisition, not primary revenue stream
+- Ensure customer service capacity for increased volume
+- Have clear fulfillment processes for digital products
+- Monitor and respond to customer feedback promptly
+
+## 7. Tips & Tricks from the Community
+
+**From Reddit Vendor Discussions:**
+- "The idea is they make a big discount on your product, and then handle all the marketing/distribution, and even some paid ads if it makes sense"
+- Some vendors report mixed experiences with customer service
+- Lifetime deals can be controversial - ensure you can truly honor them long-term
+- Multiple vendors note importance of having realistic expectations about revenue
+
+**Community Warnings:**
+- Several users report issues with certain third-party vendors on the platform
+- Lifetime subscription disputes have occurred with various products
+- Customer complaints about some vendors not honoring promised services
+- Mixed reviews on product quality and vendor reliability
+
+**Success Factors:**
+- Legitimate products from established companies tend to perform better
+- Clear communication about what customers receive is crucial
+- Responsive customer support is essential
+- Partner directly with reputable companies (not just resellers)
+
+## 8. Common Mistakes / Gotchas
+
+**Major Pitfalls:**
+1. **Overcommitting on Lifetime Deals**: Many vendors struggle to honor "lifetime" commitments long-term
+2. **Inadequate Customer Service**: High volume from deals can overwhelm unprepared support teams
+3. **Third-Party Vendor Issues**: Using unauthorized resellers can lead to invalid licenses or keys
+4. **MSRP Inflation**: FTC requires legitimate MSRP reflecting substantial sales
+5. **Reserved Quantity Failures**: Not maintaining exclusive inventory can result in fees/chargebacks
+
+**Revenue Expectations:**
+- Don't expect high profit margins - treat as customer acquisition
+- StackCommerce takes significant platform fees
+- Factor in customer service costs for increased volume
+- Plan for potential refunds and support issues
+
+**Legal Considerations:**
+- Review vendor terms carefully regarding liability and indemnification
+- Understand confidentiality requirements
+- Ensure compliance with applicable laws in all jurisdictions
+- Be prepared for potential disputes resolution through arbitration
+
+**Technical Issues:**
+- Have robust fulfillment systems for digital products
+- Ensure license keys/codes are legitimate and properly sourced
+- Plan for traffic spikes during promotions
+- Test redemption processes thoroughly
+
+## 9. Pre-Launch Checklist
+
+**Business Preparation:**
+- [ ] Legal review of StackCommerce vendor agreement
+- [ ] Insurance verification and StackCommerce naming as insured
+- [ ] Tax registration in required jurisdictions
+- [ ] Customer service capacity planning
+
+**Product Readiness:**
+- [ ] Verify MSRP legitimacy and FTC compliance
+- [ ] Secure Reserved Quantities for exclusive StackSocial inventory
+- [ ] Test fulfillment and redemption processes
+- [ ] Prepare customer onboarding materials
+
+**Marketing Assets:**
+- [ ] High-resolution product logos and images
+- [ ] Professional product screenshots
+- [ ] Compelling product descriptions optimized for deals audience
+- [ ] Demo videos showcasing key features
+- [ ] Customer testimonials and social proof
+
+**Operational Setup:**
+- [ ] Customer service protocols for increased volume
+- [ ] Fulfillment processes for digital delivery
+- [ ] Monitoring systems for deal performance
+- [ ] Escalation procedures for issues
+
+**Financial Planning:**
+- [ ] Revenue modeling with StackCommerce fees factored
+- [ ] Customer acquisition cost calculations
+- [ ] Lifetime value projections for acquired customers
+- [ ] Refund and chargeback reserves
+
+## 10. Post-Launch Checklist
+
+**Immediate (First 24-48 Hours):**
+- [ ] Monitor deal performance and customer feedback
+- [ ] Respond promptly to customer service inquiries
+- [ ] Track fulfillment processes and resolve any technical issues
+- [ ] Engage with StackSocial community discussions if applicable
+
+**Short-term (First Week):**
+- [ ] Analyze traffic and conversion metrics
+- [ ] Gather customer feedback and testimonials
+- [ ] Address any negative reviews or complaints
+- [ ] Optimize fulfillment processes based on early learnings
+
+**Medium-term (First Month):**
+- [ ] Evaluate overall campaign performance vs. goals
+- [ ] Calculate true customer acquisition cost
+- [ ] Plan follow-up marketing to acquired customers
+- [ ] Document lessons learned for future deals
+
+**Long-term (Ongoing):**
+- [ ] Honor all lifetime commitments made during promotion
+- [ ] Maintain customer relationships acquired through the platform
+- [ ] Consider repeat promotions with StackSocial
+- [ ] Monitor brand reputation and address issues promptly
+
+**Success Metrics to Track:**
+- Total units sold and revenue generated
+- Customer acquisition cost vs. lifetime value
+- Customer satisfaction scores and reviews
+- Support ticket volume and resolution time
+- Long-term retention of acquired customers
+
+---
+
+*This guide is based on publicly available information and community experiences as of March 2026. Terms and processes may change. Always verify current requirements directly with StackCommerce before proceeding.*

package/skills/startup-launcher/references/platforms/startupstash.md

@@ -0,0 +1,326 @@
+# Startup Stash Platform Guide
+
+## 1. Platform Overview
+
+**What it is:** Startup Stash is one of the world's largest online directories of tools and resources for startups and entrepreneurs. Founded in 2014 by Dutch entrepreneur Bram Kanstein as a weekend side project, it has grown to become the most upvoted product of all-time on Product Hunt with over 1 million users. The platform features a curated collection of over 1,000+ startup tools across 40+ categories, making it a go-to resource for founders looking to discover everything from development tools to marketing software to design resources.
+
+**Who runs it:** Originally created by Bram Kanstein (@bramk), a non-technical product builder who has built and sold 5 products. Startup Stash was acquired by an Israeli media company in November 2017 and is currently operated by Startup Stash LTD. According to recent information, the platform continues to be actively maintained with regular tool additions and updates.
+
+**URL:** https://startupstash.com/
+
+**Category:** Startup tool directory / Business resource discovery platform
+
+**Notable Achievement:** Startup Stash holds the record as the #1 all-time most upvoted product on Product Hunt, demonstrating exceptional community support and validation. This achievement gives it significant credibility and authority in the startup ecosystem.
+
+## 2. Key Stats
+
+**Domain Rating:** 68 (verified March 2026 via Ahrefs-based reporting) - This is considered high authority for SEO backlinks and organic search rankings.
+
+**Monthly Traffic:** 8,700 monthly visitors according to Exploding Topics Analytics (January 2026 data), with US ranking #430,990. Previous reports have cited higher numbers, but current verified data shows this more modest figure, suggesting traffic fluctuations over time.
+
+**Audience Size:** Hundreds of thousands of users access the platform monthly according to their marketing materials, though current verified traffic appears lower than historical peaks. The platform maintains active social presence with 2,822 LinkedIn followers and established Twitter/X account @startupstash since September 2014.
+
+**Tool Count:** 1,000+ tools across 40+ categories as of 2026, including major platforms like HubSpot, GitHub, Slack, Asana, Figma, and Discord - all with verified status badges.
+
+**Pricing:** Free to submit with curated approval process. No listing fees mentioned in current documentation.
+
+**Backlink Value:** High-value backlinks due to DR 68 authority. Mix of dofollow and nofollow links with strong SEO benefits.
+
+**Social Media Presence:** 
+- Twitter/X: @startupstash (joined September 2014)
+- LinkedIn: 2,822 followers
+- Instagram: @startupstash (126 followers, 5 posts)
+- Facebook: Active with regular tool features
+
+## 3. Who Should Use This
+
+**Best Fit Products:**
+- B2B SaaS tools targeting startups and small businesses
+- Development tools, APIs, and technical resources
+- Marketing automation and growth tools
+- Design software and creative tools
+- Business management and collaboration platforms
+- Any tool solving real problems for the startup/entrepreneurial community
+- Products that complement other tools in the startup ecosystem
+
+**Ideal User Profiles:**
+- Established tools with functional products (not concepts or ideas)
+- Tools with clear value propositions for business users
+- Products with professional branding and presentation
+- Services that fit within their existing category structure
+- Tools used by entrepreneurs, founders, developers, marketers, or startup teams
+
+**Not Ideal For:**
+- Consumer-focused apps or games
+- Highly niche or academic tools
+- Incomplete or beta products without clear functionality
+- Products targeting large enterprises exclusively
+- Tools without clear business application
+- Platforms that compete directly with Startup Stash itself
+
+## 4. Submission Process
+
+**Step-by-Step Process:**
+
+1. **Visit the submission page:** Navigate to https://startupstash.com/add-listing/ or click "List A Product" in the main navigation. The submission form is integrated into their website.
+
+2. **Complete required personal information:**
+   - First Name (required)
+   - Last Name (required)
+   - Email Address (required - use professional email for best response rates)
+   - Company/Organization details
+
+3. **Enter detailed product information:**
+   - **Product Name:** Clear, professional name without excessive punctuation or marketing speak
+   - **Website URL:** Must be a functional, live website or app store link
+   - **Short Description:** Maximum 160 characters - concise elevator pitch of what your tool does
+   - **Long Description:** Maximum 500 characters - detailed value proposition including who it's for and key benefits
+   - **Category Selection:** Choose from their predefined categories (browse existing categories first)
+
+4. **Upload required assets:**
+   - **Logo:** Square format strongly preferred, PNG or JPG format, under 10MB file size
+   - **Screenshots:** Product images showing the tool in action (optional but recommended)
+   - **Demo Video:** Optional but can significantly improve approval chances
+
+5. **Review promotional options:**
+   - Check if any paid promotional opportunities are available
+   - Review terms and conditions
+   - Verify all information is accurate
+
+6. **Submit and confirmation:**
+   - Click Submit button
+   - Receive confirmation message: "Thanks for applying to be listed on Startup Stash! We'll get back in touch as soon as we can :)"
+   - Monitor email for approval status (typically 1-3 weeks response time)
+
+**ACTUAL Submission URL:** https://startupstash.com/add-listing/
+
+## 5. Requirements
+
+**Essential Requirements:**
+- Functional product with live, accessible website or app
+- Professional square logo in PNG/JPG format (under 10MB)
+- Clear, business-focused value proposition
+- Legitimate startup/business tool (not consumer entertainment apps)
+- Professional email address for communication
+- Well-designed landing page that explains the product clearly
+
+**Recommended Assets for Higher Approval Rates:**
+- High-quality product screenshots demonstrating key features
+- Professional product demo video (under 2 minutes)
+- Clear pricing information on your website
+- Professional product photography and visual assets
+- Case studies or user testimonials
+- Integration documentation if applicable
+
+**Technical Requirements:**
+- Website must load properly and be mobile-friendly
+- Clear navigation and professional design
+- Contact information and support documentation
+- Privacy policy and terms of service (increasingly important)
+- SSL certificate and secure website infrastructure
+
+**Content Quality Standards:**
+- Descriptions must be clear and jargon-free
+- No excessive promotional language or hype
+- Accurate representation of features and capabilities
+- Proper grammar and spelling
+- Professional tone appropriate for business audience
+
+## 6. Strategy & Tips
+
+**Platform-Specific Best Practices:**
+
+**Optimize for Their Audience:**
+- Focus on how your tool helps startups specifically, not just businesses in general
+- Highlight features most relevant to early-stage companies (cost-effectiveness, ease of setup, scalability)
+- Use language that resonates with entrepreneurs and founders
+- Emphasize rapid deployment and quick time-to-value
+
+**Category Selection Strategy:**
+- Research existing tools in your target category before submitting
+- Choose the most specific category that fits your tool
+- Avoid overly broad categories with high competition
+- Consider secondary categories where your tool might also fit
+
+**Timing and Submission Quality:**
+- Submit during business days (Tuesday-Thursday) for potentially faster review
+- Ensure your website is optimized for traffic influx before submitting
+- Have customer support ready for increased inquiries
+- Prepare press kit materials for potential follow-up requests
+
+**Long-term Platform Relationship:**
+- Engage with other listed tools and build community relationships
+- Monitor your listing for accuracy and request updates when needed
+- Share your Startup Stash listing on social media and in press materials
+- Consider sponsorship opportunities if they become available
+
+**SEO and Backlink Strategy:**
+- Leverage the high DR 68 backlink in your SEO strategy
+- Include the listing in your press and media kit
+- Use the verification badge in marketing materials (if provided)
+- Monitor the backlink health and report any issues promptly
+
+## 7. Tips & Tricks from the Community
+
+**Based on extensive Reddit searches and community analysis:**
+
+After searching multiple Reddit communities and startup forums with queries including "startup stash" site:reddit.com, "startupstash" site:reddit.com, "startup stash review", and "startup stash submission", **no specific Reddit discussions were found containing detailed user experiences about submitting to Startup Stash.**
+
+**General Community Insights from Available Sources:**
+
+**From Founder Experience (Bram Kanstein's Public Statements):**
+- "I built Startup Stash as a curated directory - curation was always the key differentiator"
+- Platform was designed to solve the problem of tool discovery for entrepreneurs
+- Quality over quantity was the founding principle
+- The most upvoted Product Hunt record demonstrates strong community validation
+
+**From Platform Observation:**
+- All major tools (HubSpot, GitHub, Slack, Figma, etc.) have "Verified" badges, suggesting verification process adds credibility
+- Many listings include "Free Tool" badges, indicating they value and highlight free resources
+- Categories are well-organized and specific, suggesting targeted submission strategy is important
+
+**From Business Directory Analysis:**
+- BusinessDirectorySites.com notes: "The resources listed on Startup Stash are curated, which means they are vetted for quality and relevance, saving users time on research and due diligence"
+- SaaSHub review states: "The resources listed on Startup Stash are curated, which means they are vetted for quality and relevance"
+
+**Search Query Documentation:**
+Searched extensively on Reddit using: "startup stash" site:reddit.com, "startupstash" site:reddit.com, "startup stash review", "startup stash submission", "submitted to startup stash", "listed on startup stash" - no specific submission experiences found as of March 2026.
+
+## 8. Common Mistakes / Gotchas
+
+**Platform-Specific Submission Failures:**
+
+**Content and Presentation Issues:**
+- Submitting consumer apps rather than business/startup tools
+- Using generic stock photography instead of actual product screenshots
+- Writing vague descriptions that don't clearly explain what the tool does
+- Including excessive marketing language or buzzwords in descriptions
+- Submitting products that are still in concept phase rather than functional tools
+
+**Technical and Quality Issues:**
+- Poor website design or functionality issues that reflect poorly on product quality
+- Missing essential pages (pricing, contact, support, privacy policy)
+- Broken links or non-responsive website design
+- Logo files that are too large or poor quality/resolution
+- Inconsistent branding between submission and actual website
+
+**Category and Positioning Mistakes:**
+- Choosing overly broad categories where the tool gets lost
+- Misrepresenting the product's primary function or target audience
+- Submitting tools that don't align with startup/entrepreneur needs
+- Failing to research existing tools in the same category
+- Not highlighting what makes the tool unique in a crowded category
+
+**Follow-up and Communication Failures:**
+- Using unprofessional email addresses for submission
+- Not monitoring email for approval feedback or requests for clarification
+- Failing to respond promptly to questions about the submission
+- Not having media assets ready if requested for featured placement
+
+**Post-Submission Issues:**
+- Website not ready to handle traffic influx from the directory
+- No analytics set up to track referral traffic effectiveness
+- Missing clear call-to-action on landing page for Startup Stash visitors
+- Not leveraging the listing for additional marketing opportunities
+
+## 9. Pre-Launch Checklist
+
+**Before Submitting to Startup Stash:**
+
+**Product Readiness:**
+- [ ] Product is fully functional with live website/app
+- [ ] Clear value proposition specifically for startup/entrepreneur audience
+- [ ] Professional branding and visual identity completed
+- [ ] User onboarding process tested and optimized
+- [ ] Customer support system in place for increased inquiries
+- [ ] Pricing information clearly displayed on website
+
+**Content Preparation:**
+- [ ] Professional square logo created (PNG/JPG, under 10MB)
+- [ ] High-quality product screenshots captured
+- [ ] 160-character short description written and tested
+- [ ] 500-character detailed description crafted
+- [ ] Demo video created (optional but recommended)
+- [ ] Category research completed - best fit category identified
+
+**Website Optimization:**
+- [ ] Website is mobile-responsive and loads quickly
+- [ ] Clear navigation and professional design implementation
+- [ ] Privacy policy and terms of service pages added
+- [ ] SSL certificate installed and security measures in place
+- [ ] Contact information and support documentation easily accessible
+- [ ] Analytics tracking set up (Google Analytics, etc.)
+
+**Marketing Preparation:**
+- [ ] Press kit materials prepared for potential media opportunities
+- [ ] Social media posts drafted to announce listing (once approved)
+- [ ] Team prepared for potential traffic increase
+- [ ] Customer success stories or testimonials ready to share
+- [ ] Email sequences prepared for new users from directory traffic
+
+**Technical Infrastructure:**
+- [ ] Website can handle increased traffic load
+- [ ] Customer support email and chat systems tested
+- [ ] Integration documentation updated (if applicable)
+- [ ] Backup systems and monitoring in place
+- [ ] Performance monitoring tools configured
+
+## 10. Post-Launch Checklist
+
+**After Startup Stash Approval:**
+
+**Immediate Actions (First 48 Hours):**
+- [ ] Verify listing appears correctly with all information accurate
+- [ ] Set up tracking to measure referral traffic from startupstash.com
+- [ ] Share the listing on company social media channels
+- [ ] Add Startup Stash badge/mention to press kit and website
+- [ ] Monitor website performance for any traffic spikes
+- [ ] Respond to any immediate user inquiries
+
+**Week 1-2 Follow-up:**
+- [ ] Analyze referral traffic patterns and user behavior
+- [ ] Engage with any user feedback or reviews
+- [ ] Share the listing with your network and community
+- [ ] Consider reaching out to other listed tools for potential partnerships
+- [ ] Document the listing for future investor/partnership presentations
+
+**Monthly Maintenance:**
+- [ ] Monitor listing for accuracy and request updates if needed
+- [ ] Track long-term SEO improvements from the backlink
+- [ ] Measure conversion rates from Startup Stash traffic
+- [ ] Consider opportunities for greater platform engagement
+- [ ] Update product screenshots or description if major changes occur
+
+**Long-term Strategy:**
+- [ ] Build relationships within the Startup Stash community
+- [ ] Leverage verification status in marketing materials
+- [ ] Use listing as social proof for other directory submissions
+- [ ] Monitor competitor listings and category changes
+- [ ] Consider sponsored placement opportunities if available
+
+**Analytics and Optimization:**
+- [ ] Set up UTM parameters for tracking Startup Stash traffic
+- [ ] Monitor keyword rankings for branded terms
+- [ ] Track conversion funnel from directory to customer
+- [ ] Document lessons learned for future directory submissions
+- [ ] Measure overall impact on brand awareness and customer acquisition
+
+**Community Engagement:**
+- [ ] Follow Startup Stash on social media for platform updates
+- [ ] Engage with their content when relevant to build relationship
+- [ ] Share valuable resources with the Startup Stash team
+- [ ] Provide feedback or testimonials if requested
+- [ ] Stay informed about platform changes or new opportunities
+
+---
+
+*Research conducted March 8, 2026. Platform policies and processes may change over time. Always verify current requirements on the official Startup Stash website before submitting. This guide is based on comprehensive research including website analysis, community forums, founder interviews, and traffic analytics.*
+
+**Sources:**
+- Startup Stash official website (startupstash.com)
+- Exploding Topics Analytics (January 2026 traffic data)
+- Ahrefs Domain Rating data (March 2026)
+- Bram Kanstein founder interviews and public statements
+- Reddit community searches (no specific submission experiences found)
+- Business directory and SEO tool analyses
+- Social media presence verification