How to Create Custom Challenges

devActivity.com empowers Org Admins and Team Managers to create custom challenges, offering tailored recognition for specific GitHub issues. This guide walks you through the process of setting up unique challenges with personalized XP rewards and custom achievement badges.

Permissions for Custom Challenge Configuration

Access to custom challenge configuration is tiered:

• Org Admin: Full privileges to view and create custom challenges across the organization.
• Team Manager: Can view and create custom challenges specifically for their assigned team(s).
• Org Contributor: Has view-only access to custom challenges.

Step-by-Step: Creating a Custom Challenge

1. Navigate to Configure Challenges

   From your devActivity.com dashboard, go to the 'Rewards' section and then select the 'Configure Challenges' sub-tab. This is where you'll manage all challenge types.

2. Initiate Creation

   Click on the 'Create Custom Challenge' button. This action will open a modal window titled 'Configure Custom Challenge', where you'll define the challenge details.

   

3. Define Challenge Goal

   In the 'Configure Custom Challenge Goal' section:

   • Link GitHub Issue: Enter the full 'GitHub Issue URL' that this challenge will be associated with (e.g., https://github.com/repositoryname/issues/1). The challenge's completion will be directly tied to the resolution of this issue.
   • Create New Issue: If the relevant GitHub issue doesn't exist yet, click the 'Create new Issue' button to generate one directly.
   • Notifications: Use the 'Notify all Contributors about this challenge via Email/Slack' toggle to automatically inform team members about the new challenge.

4. Configure Challenge Reward

   In the 'Configure Custom Challenge Reward' section, personalize the recognition:

   • Title: Provide a concise and descriptive title for the challenge using the input field labeled 'Specify or select title here'.
   • Assign Contributor: Select the 'Issue Assignee(s)' who will be eligible to receive the challenge and its reward. This could be the pull request author or a designated assignee for the task.
   • XP Reward: Define the amount of Experience Points (XP) the selected contributor(s) will earn upon completing the challenge (e.g., 10 XP).
   • Badge Customization: Personalize the achievement badge by specifying its 'Badge Color' (e.g., #FACC99) and 'Badge Icon' (e.g., fa-bolt). For advanced customization, enable the 'Use custom SVG for Badge' toggle to upload a unique SVG file. A 'Click here for ideas' link is available for inspiration.

5. Save Challenge

   Once all the challenge details and rewards are configured, click the 'Save' button to activate your custom challenge. If you wish to discard changes, click 'Cancel'.

Upon successful completion of the linked GitHub issue by the assignee, the defined XP and unique badge will be automatically awarded and recorded in their devActivity.com profile.

Frequently Asked Questions

How can I create a custom challenge for a specific GitHub issue?

Navigate to 'Rewards' > 'Configure Challenges', click 'Create Custom Challenge', and then provide the 'GitHub Issue URL' in the 'Configure Custom Challenge Goal' section.

What elements can I customize for a custom challenge's goal and reward?

You can customize the linked GitHub issue, challenge title, eligible assignee(s), XP reward amount, badge color, badge icon, and even upload a custom SVG for the badge.

How are contributors notified about custom challenges and their completion?

You can enable the 'Notify all Contributors about this challenge via Email/Slack' toggle during creation. Upon completion of the linked GitHub issue, the assigned contributor automatically receives the reward.

Where will a completed custom achievement be displayed for a developer?

Upon completion, the defined XP and unique badge will be awarded and prominently displayed in the developer's personal list of rewards within devActivity.com.