Log your Google Developer Expert (GDE) Contributions to Advocu with the ease of a command line CLI.

Features

• 🚀 Interactive CLI for submitting GDE activities to Advocu
• 📝 Support for all GDE activity types:
  • Content Creation (Articles, Videos, Podcasts, etc.)
  • Public Speaking (Talks, Presentations)
  • Workshops (Training Sessions)
  • Mentoring
  • Product Feedback
  • Interaction with Googlers
  • Stories (Success Stories, Case Studies)
• 🔐 Secure token-based authentication
• 💻 Both interactive and CLI modes
• 🎨 Beautiful terminal UI with clack prompts

Installation

npm install -g gde-contributions

Or use with pnpm:

pnpm add -g gde-contributions

Usage

Interactive Mode (Recommended)

Simply run the command and follow the prompts:

gde-contributions add
# or use the short alias
gdec add

CLI Mode

You can also use CLI flags for automation:

gde-contributions add \
  --type content-creation \
  --title "My Awesome Article" \
  --description "A comprehensive guide to..." \
  --date 2024-01-15 \
  --content-type Articles \
  --url https://example.com/article \
  --readers 5000 \
  --no-interactive

Activity Types

Content Creation

Submit articles, videos, podcasts, books, demos, and more.

gdec add --type content-creation

Public Speaking

Log your conference talks and presentations.

gdec add --type public-speaking

Workshop

Record training sessions and workshops.

gdec add --type workshop

Mentoring

Track your mentoring activities.

gdec add --type mentoring

Product Feedback

Submit product feedback, bug reports, and feature requests.

gdec add --type product-feedback-given

Interaction with Googlers

Log your interactions with Google employees.

gdec add --type interaction-with-googlers

Stories

Share success stories and case studies.

gdec add --type stories

Authentication

On first run, you'll be prompted to enter your Advocu access token. Get your token from advocu.com.

The token is securely stored locally and reused for future submissions.

Commands

Add a Contribution

gde-contributions add [options]
# or
gdec a [options]

Options:

• -t, --type <type> - Activity type
• -T, --title <title> - Contribution title
• -D, --description <description> - Contribution description
• -d, --date <date> - Contribution date (YYYY-MM-DD)
• -u, --url <url> - Contribution URL
• -c, --content-type <contentType> - Content type (for content-creation)
• -e, --event-format <eventFormat> - Event format (Virtual, In-Person, Hybrid)
• -C, --country <country> - Country (for in-person/hybrid events)
• -i, --in-person-attendees <number> - In-person attendees
• -a, --attendees <number> - Total attendees
• -r, --readers <number> - Number of readers
• -s, --time-spent <number> - Time spent in minutes
• -x, --no-interactive - Disable interactive mode

Remove a Contribution

gde-contributions remove
# or
gdec r

Note: The Advocu API currently does not support removing contributions via API. Please visit advocu.com to manage your contributions.

Version

gde-contributions -v
# or
gdec --version

Help

gde-contributions -h
# or
gdec --help

Development

Setup

git clone <repository-url>
cd gde-contributions
pnpm install

Build

pnpm build

Development Mode

pnpm dev

Test Locally

pnpm build
npm link

License

MIT © Ahmad Awais

Author

Ahmad Awais (@_AhmadAwais)

Built with 💜 for the GDE community.