Sign up for clippings from Pete's garden

\n \n \n \n `)\n });\n\n return app.fetch(req);\n}","label",[137],"79908cd8-2772-11f0-b46e-569c3dd06744","README.md","79908d6e-2772-11f0-b46e-569c3dd06744",["D",1700239799740],0,"# Val Town email subscriptions 📧\n\nHandles email subscription signup+verification and sending.\n\n## Steps\n\n1. Fork and run the sibling Vals to set up SQLite tables: [createSubscribers](https://www.val.town/v/petermillspaugh/createSubscribers), [createNewsletters](https://www.val.town/v/petermillspaugh/createNewsletters), [createEmailLogs](https://www.val.town/v/petermillspaugh/createEmailLogs)\n2. Fork this Val and update for your use case (e.g. confirmation link, `sendEmail` args, form fields, etc.)\n3. Add an HTML form to your frontend that calls `/send-verification`, or just use `/` to return a simple HTML form\n4. Add a confirmation page on the frontend that calls `/confirm-verification`\n5. Fork sibling Vals to [get verification email markup](https://www.val.town/v/petermillspaugh/fetchVerificationEmailHtml), [send verification emails](https://www.val.town/v/petermillspaugh/sendVerificationEmail), [create a list of newsletters](https://www.val.town/v/petermillspaugh/newsletters), [create a newsletter template](https://www.val.town/v/petermillspaugh/generateNewsletterJsx), [create an individual newsletter](https://www.val.town/v/petermillspaugh/january2024), [send test emails](https://www.val.town/v/petermillspaugh/sendTestEmailNewsletter), [send emails](https://www.val.town/v/petermillspaugh/sendEmailNewsletter), and [handle unsubscribe](https://www.val.town/v/petermillspaugh/unsubscribeFromNewsletter)\n6. Optionally, fork cousin Vals to [view subscribers](https://www.val.town/v/petermillspaugh/getSubscribers), [email yourself daily subscriber count](https://www.val.town/v/petermillspaugh/dailySubscriptionStats), [email yourself a reminder to write your next newsletter](https://www.val.town/v/petermillspaugh/sendNewsletterReminder), and [send test emails](https://www.val.town/v/petermillspaugh/sendTestEmailNewsletter)\n\n## Frontend form\n\nYou should have a form that hits the `/send-verification` API endpoint on submit. **Remember to adjust the endpoint URL to that of your fork** (or else you'll be signing people up for my website!). As a simple alternative, you could use the `/` handler of this Val, which returns a simple HTML form. Here's a simple example using React:\n\n```tsx\nconst EmailSignupForm = () => {\n const [name, setName] = useState(\"\");\n const [email, setEmail] = useState(\"\");\n\n async function handleSubmit(e) {\n e.preventDefault();\n setName(\"\");\n setEmail(\"\");\n\n const formData = new FormData();\n formData.append(\"name\", name);\n formData.append(\"email\", email);\n\n await fetch(\"https://petermillspaugh-emailSubscription.web.val.run/send-verification\", {\n method: \"POST\",\n body: formData,\n });\n }\n\n return (\n

\n First name\n setName(e.target.value)}\n type=\"text\"\n required={true}\n />\n Email\n setEmail(e.target.value)}\n type=\"email\"\n required={true}\n />\n \n \n );\n};\n```\n\nYou can see a full example on petemillspaugh.com: [signup in the footer](https://www.petemillspaugh.com/) and [code on github](https://github.com/pmillspaugh/petemillspaugh.com/blob/main/src/components/EmailSignup/EmailSignup.tsx).\n\nYou can add/remove input fields as you wish, of course (e.g. maybe you don't need a name, or maybe you want a how'd-you-hear-about-us field). Just adjust the SQL and frontend implementation accordingly.\n\n## Frontend confirmation page\n\nCreate a confirmation page that accepts an email and token as query params and calls the `/confirm-verification` endpoint. Simple example using React (and Next.js /page directory):\n\n```tsx\nconst EmailConfirmationPage = () => {\n const router = useRouter();\n const { email, token } = router.query;\n const [isConfirmed, setIsConfirmed] = useState(false);\n\n useEffect(() => {\n async function confirmEmail() {\n if (!email || !token) return;\n\n const response = await fetch(`https://petermillspaugh-emailSubscription.web.val.run/confirm-verification?email=${email}&token=${token}`, {\n method: \"PUT\",\n });\n const { confirmed } = await response.json();\n if (confirmed) setIsConfirmed(true);\n }\n\n confirmEmail();\n }, [email, token]);\n\n if (!isConfirmed) return null;\n\n return (\n

You’re all set!

\n );\n};\n```\n\nFull example is [here](https://www.petemillspaugh.com/email-confirmation) and code is [here](https://github.com/pmillspaugh/petemillspaugh.com/blob/main/src/components/EmailConfirmation/EmailConfirmation.tsx).\n\nAs an alternative, you could make `/confirm-verification` a GET route and have your email confirmation link sent by the first route be `https://petermillspaugh-emailSubscription.web.val.run/confirm-verification?email=${email}&token=${token}` (swapping in your namespace). That would be marginally faster, probably, but you'd still need some way to convey confirmation to the user (e.g. add some \"You're all set\" message to the return). Plus, the route writes to the `subscribers` table, so a PUT feels more appropriate.\n\n## Notes\n\n- Sending emails to people other than yourself on Val Town is a paid feature—if you want to stay on the free plan, you can go with a package like [nodemailer](https://www.npmjs.com/package/nodemailer) or [@sendgrid/mail](https://www.npmjs.com/package/@sendgrid/mail)\n\nMigrated from folder: EmailSubscriptions/emailSubscription",[148],"7dac099c-6277-11f0-9fc4-0224a6c84d84","jsx","7b9a23e6-6277-11f0-b3a7-0224a6c84d84",81,["D",1752692579741],"directory",[155],"pulls","branches","forks","envVars",{"_168":66,"_170":151},"connections",{"_168":151,"_169":151},"count","unfilledCount","emptyCount",{"_46":154,"_34":155,"_32":156,"_138":-5,"_44":45,"_43":157,"_140":25,"_41":186,"_13":66,"_36":159,"_38":-5,"_24":27,"_145":-5,"_176":187,"_28":188},{"_46":182,"_34":40,"_32":33,"_138":156,"_44":45,"_43":14,"_140":27,"_41":183,"_13":66,"_36":37,"_38":39,"_24":27,"_145":-5,"_176":184,"_28":185},{"_46":147,"_34":148,"_32":149,"_138":-5,"_44":45,"_43":66,"_140":27,"_41":179,"_13":151,"_36":20,"_38":152,"_24":27,"_145":-5,"_176":180,"_28":181},{"_46":136,"_34":137,"_32":61,"_138":-5,"_44":45,"_43":139,"_140":27,"_41":175,"_13":142,"_36":143,"_38":144,"_24":27,"_145":48,"_176":177,"_28":178},["D",1752692440192],"children",[],[137],["D",1700239799740],[],[148],"8356b824-6277-11f0-b673-0224a6c84d84",["D",1752692589175],[],[155,40],["D",1752692579741],[172],[155],["D",1746203306756],["D",1789504321592],{"_103":102,"_111":107},{"_103":102,"_104":105,"_106":107,"_18":59,"_108":109,"_110":27},{"_13":92,"_34":93,"_46":45,"_94":47,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":-5,"_100":48,"_101":102},"ctx",{"_85":-5,"_130":227,"_228":229,"_230":231,"_232":27,"_233":27,"_234":27,"_235":25,"_236":-5,"_237":-7,"_238":-7,"_239":151,"_240":27,"_241":27,"_242":-5,"_243":27,"_244":27,"_245":27,"_246":-5},"ENV",{"_198":199,"_200":201,"_202":93,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v83