contraptionco

postcard: Build a Personal Website and Newsletter

Postcard is a Ruby on Rails app that combines a personal website, newsletter, and light blogging as an alternative to social media. Self-host it in solo mode or use the hosted service for a multiuser setup.

ActiveRubyGPL-3.0Web AppSelf HostedEmail
Stars
601
Forks
45
Stars, last 30 days
+1
Last commit
10 days ago
Contributors
2

Our take

Activeregular commits

Health score

39/100

How it is scored
Activity
44
Community
18
Issues
46
Pull requests
49

+1 stars in the last 30 days

  • Slower to close issues than 91% of the projects we track

Postcard is an active, practical fit for people who want an owned publishing home, though its recent development is concentrated in one contributor and it has had no release in over a year.

Good fit if

  • You want a self-hosted personal site with blogging and newsletter features, and can operate Ruby on Rails with PostgreSQL.
  • You value control over your publication and are comfortable with GPL-3.0 terms.
  • You are evaluating a project with regular recent commits and can accommodate its small contributor base.

Look elsewhere if

  • You need a project with frequent formal releases or a broader contributor base.
  • You need a quick multiuser deployment without configuring Stripe, custom-domain routing, and additional infrastructure.
  • You cannot operate the required Ruby, Node.js, and PostgreSQL stack or meet the GPL-3.0 obligations.
All health signals
Last commit2026-10-12 (10 days ago)
Commits, last 90 days94
Releases, last 12 months0
Contributors2 (top contributor: 91% of commits)
Issues closed, last 90 days19 (typically closed in 210 days)
Pull requests merged, last 90 days19 (typically merged in 1 day)
Project age16 months

Checked on 2026-10-23 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

602

Forks

45

Change since Nov 17, 2026: 0 stars·0 forks

Overview

Postcard is a Ruby on Rails app for replacing social media with a personal website, integrated newsletter, and light blogging. Write posts on your own site and share them elsewhere with automatically generated Open Graph images and metadata, while building a mailing list you control.

The project recommends solo mode for self-hosting one website. The same repository also powers postcard.page's multiuser service, which adds account hosting and custom-domain features but requires more setup, including Stripe and domain routing.

Key Features

  • Publish a personal website with light blogging and an integrated newsletter.
  • Generate Open Graph images and metadata for posts shared on social platforms.
  • Use a custom domain for a self-hosted site.
  • Run in solo mode for one site or configure multiuser mode for hosted accounts.
  • Store uploads with S3 and send production email with AWS SES.
  • Offer Google sign-in and hCaptcha protection through optional configuration.
  • Deploy with Docker or use the included Render blueprint.

Use Cases

  • A writer can publish posts on a personal site and send them to subscribers without relying on social platforms as the main home for their work.
  • A creator can establish a custom-domain website and build a mailing list they can carry across platforms.
  • A self-hoster can run a single personal publication with the simpler solo-mode setup.
  • A hosting operator can explore the multiuser setup to serve multiple personal websites, provided they are prepared to configure payments and custom-domain routing.

What you need

Detected in the repository

  • Node.js 24.x (from package.json)
  • Ruby (from Gemfile)
  • A Dockerfile, so it can run in a container
  • A test suite and automated checks on GitHub Actions

License in plain words

GPL-3.0strong copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, the full source of anything you distribute that includes it, under the GPL
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the dependencies, then run:

bundle install
npm ci
rails db:setup
./bin/dev-solo

See the README for dependency versions, production configuration, and deployment details.

Alternatives

  • keila: Keila focuses on newsletter campaigns and signup forms, while Postcard combines newsletters with a personal website and light blogging.
ProjectLanguageLicenseStarsStatus
postcardRubyGPL-3.0601Active
keilaElixirAGPL-3.02.2kActive

Considerations

Self-hosting requires Ruby on Rails, Node.js, PostgreSQL, and libvips; production setups also call for AWS S3 and SES, plus hCaptcha for spam prevention. The README describes multiuser mode as significantly more complex than solo mode, with payment processing and custom-domain infrastructure to configure. Development is active, but the project has only two contributors, most of the code comes from one person, and issue closure is relatively slow. There has been no release in over a year, so adopters should plan to follow repository changes rather than rely on a recent release cadence. GPL-3.0 is a copyleft license, which may affect how you distribute modified versions.

Found this useful?

Share it with someone who would like postcard.

Comparisons