docs: enhance Boost documentation for posts and Squads

.nvmrc

@@ -1 +1 @@
-20.12
+22

docs/monetization/boost.md

@@ -1,26 +1,33 @@
 ---
 sidebar_position: 2
-description: Boost your posts to reach more developers using daily.dev's in-app promotion tool.
+description: Boost your posts and Squads to reach more developers using daily.dev's in-app promotion tools.
 ---
 
-# Boosting your posts
+# Boost
 
 ![boost your posts](https://daily-now-res.cloudinary.com/image/upload/v1752671864/docs/boost_post.png)
 
-Promote any published post to reach more developers across daily.dev. Whether it’s on your profile or in a Squad, Post Boost helps your content get discovered. You choose how much to spend using cores and we handle the targeting and delivery.
+Grow your reach on daily.dev with our Boost tools. Promote your posts to get more views and engagement, or boost your Squad to attract new members. Whether you're sharing content or building a community, Boost helps you connect with the right developers using cores.
 
 ## Key features
 
-✨ **Automated targeting**: Our recommendation engine promotes your post to the right developers based on tags, reading habits, and engagement signals. No setup needed.
+✨ **Automated targeting**: Our recommendation engine promotes your content to the right developers based on tags, reading habits, and engagement signals. No setup needed.
 
-✨ **Flexible budget control**: Set your daily budget in cores and choose how long your boost runs. You’re always in control.
+✨ **Flexible budget control**: Set your daily budget in cores and choose how long your boost runs. You're always in control.
 
-✨ **Native placements**: Boosted posts show up in the feed, Squads, and discovery areas clearly labeled but fully integrated.
+✨ **Native placements**: Boosted content shows up in the feed, Squad directory, and discovery areas clearly labeled but fully integrated.
 
-✨ **Real-time insights**: Track spend, impressions, clicks, and engagement in the ads dashboard.
+✨ **Real-time insights**: Track spend, impressions, clicks, engagement, and growth metrics in the ads dashboard.
 
-## How to boost a post
+✨ **Two boost types**: Promote individual posts for engagement or boost entire Squads to attract new members.
 
+## Boost types
+
+### Post Boost
+
+Promote individual posts to increase views, engagement, and reach.
+
+**How to boost a post:**
 1. **Publish** your post (on your profile or in a Squad).
 2. Click **Boost**.
 3. Set your **daily budget** (in [Cores](monetization/cores.md)).
@@ -29,6 +36,25 @@ Promote any published post to reach more developers across daily.dev. Whether it
 
 ![boost your post example](https://daily-now-res.cloudinary.com/image/upload/v1752671850/docs/Screenshot_2025-07-16_at_16.14.47.png)
 
+### Squad Boost
+
+Promote your entire Squad to attract new members and grow your community.
+
+**How to boost a Squad:**
+1. Go to your **Squad page** (you must be an admin or moderator).
+2. Click **Boost**.
+3. Set your **daily budget** (in [Cores](monetization/cores.md)).
+4. Choose the **number of days** to run the promotion.
+5. Confirm the boost and let it run.
+
+![Squad Boost example](https://daily-now-res.cloudinary.com/image/upload/v1756990224/docs/Squad_Boost.png)
+
+**Requirements for Squad Boost:**
+- Squad must be public
+- Squad must have a description, profile image, and cover image
+- Only admins and moderators can boost
+- Only one boost can run at a time per Squad
+
 ## Budget and duration
 
 - **Daily budget**:  
@@ -39,45 +65,86 @@ Promote any published post to reach more developers across daily.dev. Whether it
 
 You can stop a boost anytime. Unused cores are automatically credited back to your wallet.
 
-## Where boosted posts appear
+## Where boosted content appears
 
+### Post Boost placements
 Boosted posts are featured across daily.dev in:
-
 - The home feed  
 - Squad feeds  
 - Relevant tag feeds  
 - Other discovery surfaces personalized per user
 
+### Squad Boost placements
+Boosted Squads appear as dedicated cards with Squad details in:
+- **Main feed**: Prime ad slots with "Join Squad" call-to-action
+- **Squad directory**: Featured section with priority placement
+- Squad cards show: name, description, member count, cover image, and join button
+
 All placements are labeled as *boosted* and respect the user experience.
 
 ## Performance tracking
 
-Tracking your boosted posts can be done using the ads dashboard. To access it please click on your profile image and choose "Ads dashboard" from the dropdown menu.
-
-Go to the **ads dashboard** to track:
+Track your boost campaigns using the ads dashboard. Access it by clicking on your profile image and choosing "Ads dashboard" from the dropdown menu.
 
+### Post Boost metrics
 - **Spend** – total cores used  
 - **Impressions** – how many times your post appeared  
 - **Clicks** – how many users tapped through  
 - **Engagement** – upvotes, comments, bookmarks
 
+### Squad Boost metrics
+- **Spend** – total cores used
+- **Impressions** – how many times your Squad card appeared
+- **Unique reach** – number of unique users who saw your Squad
+- **New members** – users who joined your Squad during the campaign
+
+Both boost types show real-time data and campaign progress in the ads dashboard.
+
 :::tip
 Try running shorter, high-budget boosts to spike discovery during key moments, like a product launch or new article drop.
 :::
 
+## Supporting Squad growth
+
+You don't need to be an admin or moderator to help Squads grow. **Awards** are a great way to support your favorite communities:
+
+- Give Awards on Squad posts or directly to the Squad itself
+- Awards transfer cores directly to Squad admins and moderators  
+- They can use those cores to boost the Squad and attract more members
+- It's a community-driven way to help Squads you love reach more developers
+
+## Managing active boosts
+
+### Squad Boost management
+- **Campaign status**: When a Squad is being boosted, the boost button shows "Boosting" in a disabled state
+- **Stop anytime**: Only the person who started the boost can stop it via "Manage ad" in the three-dot menu
+- **One at a time**: Only one admin/mod can boost a Squad at any given time
+- **Refunds**: Unused cores are automatically refunded when you stop a campaign early
+
+### Notifications
+You'll receive notifications when:
+- Your boost campaign completes (both email and in-app)
+- Campaign progress updates during longer boosts
+
 ## FAQs
 
 **Can I boost Squad posts?**  
 Yes. Post Boost works for any published post, including those in Squads.
 
+**Can I boost private Squads?**  
+No. Only public Squads can be boosted.
+
 **Do I need to configure targeting?**  
-No. Targeting is handled automatically using our in-house engine.
+No. Targeting is handled automatically based on Squad categories and content tags.
 
 **Can I run multiple boosts at once?**  
-Yes. You can promote multiple posts in parallel.
+Yes for Post Boosts. For Squad Boosts, only one can run per Squad at a time.
+
+**What if my Squad doesn't have required details?**  
+You'll be prompted to add a description, profile image, and cover image in Squad settings before boosting.
 
 **Where can I see results?**  
-Check the ads dashboard for real-time metrics on each boost.
+Check the ads dashboard for real-time metrics on each boost campaign.
 
 ## Need help?
 

docs/squads/growing-your-squad.md

@@ -78,6 +78,29 @@ To improve your chances of being featured in the directory:
 2. **Grow Membership**: Invite members to join and participate actively.  
 3. **Post Consistently**: Regular high-quality posts boost engagement and visibility.  
 
+## Accelerate Growth with Boost
+
+Ready to fast-track your Squad's growth? **Boost** gives admins and moderators powerful tools to reach more developers and grow faster.
+
+### Squad Boost
+Promote your entire Squad to attract new members:
+- **Targeted exposure**: Your Squad appears as dedicated cards in the main feed and Squad directory
+- **Smart targeting**: Automatically shown to developers interested in your Squad's topics
+- **Full control**: Set your budget in [cores](/docs/monetization/cores) and track new members in real-time
+- **Requirements**: Squad must be public with description, profile image, and cover image
+
+### Post Boost  
+Amplify your Squad's best content:
+- **Boost Squad posts**: Promote high-quality posts from your Squad to reach more developers
+- **Increase engagement**: Get more views, upvotes, and comments on important content
+- **Cross-promotion**: Boosted Squad posts can attract users to join your community
+
+:::tip
+Combine both strategies: Use Squad Boost for member acquisition and Post Boost to showcase your best content. Members can also support your Squad by giving [Awards](/docs/monetization/cores#awards), which transfer cores directly to admins and moderators for future boosts.
+:::
+
+**Ready to boost?** Visit your Squad page and click "Boost" or learn more in our [Boost documentation](/docs/monetization/boost).
+
 ## Building an Engaged Community
 
 An active Squad is key to growth. By regularly posting, approving member contributions, and sparking discussions, your Squad can become a vibrant hub for developers.

package.json

@@ -44,6 +44,9 @@
     "react-dom": "^18.3.1",
     "url-loader": "^4.1.1"
   },
+  "engines": {
+    "node": "22.x"
+  },
   "browserslist": {
     "production": [
       ">0.5%",

src/components/homepage/homeNavBoxes.js

@@ -120,7 +120,7 @@
     items: [
       { url: 'docs/monetization/cores', text: 'Cores' },
       { url: 'docs/monetization/awards', text: 'Awards' },
-      { url: 'docs/monetization/boost', text: 'Post boost' },
+      { url: 'docs/monetization/boost', text: 'Boost' },
     ],
   },
   {
@@ -157,7 +157,7 @@
   },
 ];
 
 function FeatureItem({ url, text }) {
   return (
     <li>
       <Link className={styles.listContainerLink} to={url}>
@@ -167,7 +167,7 @@
   );
 }
 
 function Feature({ title, icon, items }) {
   const altTexts = {
     'Getting Started': 'Navigate to getting started guides and tutorials',
     'Setting up your feed': 'Customize and configure your content feed',

vercel.json

@@ -1,4 +1,5 @@
 {
   "cleanUrls": true,
-  "trailingSlash": false
+  "trailingSlash": false,
+  "framework": "docusaurus"
 }