mantoshkumar1 / mantoshkumar1/mantoshkumar1.github.io

Fix newsletter signup flow requiring the email address twice

Open
#35 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
1
Forks
0
Avg merge
13m
Merged PRs (30d)
2

Description

Priority: High

Problem

The newsletter signup flow at https://mantoshkumar1.github.io/newsletter/ appears to require a visitor to enter their email address twice during subscription. This is confusing and creates unnecessary friction; it was confusing even during owner testing.

Goal

Understand exactly why the duplicate email-entry step occurs and reduce the signup flow to the simplest safe experience Buttondown supports.

Scope

  • Reproduce the full subscription flow from the website.
  • Identify which step is controlled by this repository versus Buttondown.
  • Determine whether the second email-entry step is required, configurable, or avoidable.
  • Review the redirect/confirmation flow for unnecessary or unclear steps.
  • Preserve double opt-in if required for consent/deliverability; the objective is to remove duplicate data entry, not weaken confirmation.
  • Test the final flow on desktop and mobile.

Acceptance criteria

  • The current signup flow is documented step by step.
  • The reason the email must currently be entered twice is identified.
  • Duplicate email entry is removed if technically possible without weakening opt-in safety.
  • If Buttondown requires it, the UI clearly explains what is happening and why.
  • A first-time visitor can subscribe without confusion on desktop and mobile.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the signup flow at https://mantoshkumar1.github.io/newsletter/ on desktop and mobile, documenting each step. Trace which steps belong to this repository and which are controlled by Buttondown, then review the redirect and confirmation flow. Done means duplicate entry is removed where safe, or the required step is clearly explained without weakening double opt-in.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
frontend, web-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.