$npx -y skills add jonathimer/devmarketing-skills --skill developer-signup-flowDesign frictionless signup experiences for developers including GitHub OAuth, API key generation, and onboarding personalization. Trigger phrases: developer signup, dev registration, OAuth flow, API key onboarding, reduce signup friction, developer authentication, signup conversi
| 1 | # Developer Signup Flow |
| 2 | |
| 3 | Create signup experiences that respect developers' time and get them to code as fast as possible. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | Developer signup is your first chance to demonstrate that you understand developers. Every unnecessary form field, every extra click, every "verify your email before continuing" is a message that you don't value their time. The best developer signups feel like they barely exist—developers go from "I want to try this" to "I'm writing code" in under 60 seconds. |
| 8 | |
| 9 | This skill covers OAuth integration, API key generation UX, progressive profiling, and measuring what actually matters in signup conversion. |
| 10 | |
| 11 | ## Before You Start |
| 12 | |
| 13 | Review the `/devmarketing-skills/skills/developer-audience-context` skill to understand your target developer segments. Signup optimization varies significantly based on whether you're targeting hobbyists exploring on weekends versus enterprise developers evaluating tools for their company. |
| 14 | |
| 15 | ## OAuth Options That Work |
| 16 | |
| 17 | ### The GitHub-First Approach |
| 18 | |
| 19 | For developer tools, GitHub OAuth should be your primary option. Here's why: |
| 20 | |
| 21 | 1. **Identity verification built-in** - Active GitHub accounts have commit history, repos, and social proof |
| 22 | 2. **Scope familiarity** - Developers understand GitHub's permission model |
| 23 | 3. **Profile data** - You get username, email, and can infer experience level from public activity |
| 24 | 4. **Trust signal** - GitHub is where developers already live |
| 25 | |
| 26 | **Good implementation (Vercel):** |
| 27 | - Single "Continue with GitHub" button dominates the page |
| 28 | - Email option available but secondary |
| 29 | - No password creation required |
| 30 | - Immediate redirect to dashboard after OAuth |
| 31 | |
| 32 | **Bad implementation:** |
| 33 | - GitHub, Google, Twitter, LinkedIn, Email, and "Sign up with phone" all given equal prominence |
| 34 | - Requires email verification even after GitHub OAuth |
| 35 | - Asks for additional profile information before showing dashboard |
| 36 | |
| 37 | ### OAuth Option Hierarchy |
| 38 | |
| 39 | Prioritize based on your audience: |
| 40 | |
| 41 | | Audience | Primary | Secondary | Avoid | |
| 42 | |----------|---------|-----------|-------| |
| 43 | | Open source developers | GitHub | Email | Google Workspace | |
| 44 | | Startup developers | GitHub | Google | Enterprise SSO | |
| 45 | | Enterprise developers | SSO/SAML | Google Workspace | Social logins | |
| 46 | | Data scientists | GitHub | Google | Twitter | |
| 47 | | Mobile developers | Google | GitHub | Facebook | |
| 48 | |
| 49 | ### Google OAuth Considerations |
| 50 | |
| 51 | Google OAuth works well when: |
| 52 | - Your tool integrates with Google Cloud services |
| 53 | - You're targeting Android developers |
| 54 | - Your audience includes non-technical stakeholders (product managers, designers) |
| 55 | |
| 56 | Google OAuth fails when: |
| 57 | - Developers use personal Gmail but need to sign up with work identity |
| 58 | - Your tool has no Google ecosystem integration |
| 59 | - You require Google Workspace-specific scopes |
| 60 | |
| 61 | ### Email Signup: When It Makes Sense |
| 62 | |
| 63 | Email+password signup should exist but not dominate. It serves: |
| 64 | - Developers in enterprise environments that block OAuth |
| 65 | - Privacy-conscious developers who limit third-party access |
| 66 | - Situations where GitHub/Google accounts don't reflect professional identity |
| 67 | |
| 68 | **If you support email signup:** |
| 69 | - Allow signup with just email—send magic link, don't require password creation |
| 70 | - Never require email verification before showing the dashboard |
| 71 | - Offer "Set password later" for developers who prefer magic links |
| 72 | |
| 73 | ## Reducing Form Fields |
| 74 | |
| 75 | ### The Zero-Field Ideal |
| 76 | |
| 77 | The best signup has zero custom fields. Everything you need comes from OAuth: |
| 78 | - Name (from OAuth profile) |
| 79 | - Email (from OAuth profile) |
| 80 | - Username/handle (from GitHub username) |
| 81 | - Avatar (from OAuth profile) |
| 82 | |
| 83 | ### When You Must Ask Questions |
| 84 | |
| 85 | If you genuinely need information, defer it: |
| 86 | |
| 87 | **Bad: Blocking signup** |
| 88 | ``` |
| 89 | Create Account |
| 90 | |
| 91 | - Password |
| 92 | - Company Name (required) |
| 93 | - Role (required) |
| 94 | - Team Size (required) |
| 95 | - How did you hear about us? (required) |
| 96 | [Create Account] |
| 97 | ``` |
| 98 | |
| 99 | **Good: Progressive collection** |
| 100 | ``` |
| 101 | Continue with GitHub |
| 102 | [Immediate dashboard access] |
| 103 | |
| 104 | [Later, contextually in dashboard] |
| 105 | "To customize your experience, what are you building?" |
| 106 | [ ] API/Backend |
| 107 | [ ] Web app |
| 108 | [ ] Mobile app |
| 109 | [ ] Data pipeline |
| 110 | [Skip for now] |
| 111 | ``` |
| 112 | |
| 113 | ### Field Elimination Checklist |
| 114 | |
| 115 | For each field you want to add, answer: |
| 116 | - Can we infer this from OAuth profile data? |
| 117 | - Can we infer this from behavior after signup? |
| 118 | - Can we ask this later when context makes it relevant? |
| 119 | - What decision does this field enable that can't wait? |
| 120 | - What's the conversion cost of this field? |
| 121 | |
| 122 | Research suggests each additional required field reduces conversion by 5-10%. |
| 123 | |
| 124 | ## API Key Generation UX |
| 125 | |
| 126 | ### Immediate Key Generation |
| 127 | |
| 128 | Developers sign up to write code. Show them an API key immediate |