forem /forem

For empowering community 🌱

★ 22,832⑂ 4,270👁 351⑃ 17,015● 6,051▤ 0
RubyAGPL-3.0Created 2016-11-13forem.com
22,832
stars
4,270
forks
351
watchers
17,015
prs
6,051
issues
0
releases

README

Forem 🌱
  For Empowering Community



  


Welcome to the Forem codebase, the platform that powers
dev.to. We are so excited to have you. With your help, we can
build out Forem’s usability, scalability, and stability to better serve our
communities.

 What is Forem?

Forem is open source software for building communities. Communities for your
peers, customers, fanbases, families, friends, and any other time and space
where people need to come together to be part of a collective.
See our announcement post
for a high-level overview of what Forem is.

dev.to (or just DEV) is hosted by Forem. It is a community of
software developers who write articles, take part in discussions, and build
their professional profiles. We value supportive and constructive dialogue in
the pursuit of great code and career growth for all members. The ecosystem spans
from beginner to advanced developers, and all are welcome to find their place
within our community. ❤️

 Table of Contents

- What is Forem?
- Table of Contents
- Contributing
- Getting Started
  - Installation Documentation
- Developer Documentation
- Deployment with Kamal (Beta)
- Vulnerability Disclosure
- Acknowledgements
- License


 Contributing

We welcome pull requests on any issue, regardless of its current status, if it provides a fix or improvement. While we cannot guarantee that every PR will be merged, we value legitimate suggestions and contributions.

All pull requests should include appropriate tests. Our current focus is primarily on backend-related regression tests, while frontend changes may require more extensive user review.

We welcome AI-assisted pull requests but will turn away "slop" — all submissions must maintain high standards of code quality and meaningful utility.

 🤖 AI Agents: Check out AGENTS.md for more instructions. Forem also synchronizes these rules across .cursorrules, .windsurfrules, and .github/copilot-instructions.md for specific IDEs and environments.

Please also check out the Contributing to Forem guide for more detailed guidelines.


 Getting Started

This section provides a high-level quick start guide. If you're looking for a more thorough installation guide (for example with macOS), you'll want to refer to our complete Developer Documentation.

We run on a Rails backend, and we are currently transitioning to a Preact-first frontend.

 Prerequisites Note: Forem now utilizes advanced AI embeddings for feed generation. You must ensure your PostgreSQL installation has the pgvector extension (version 0.8.0 or higher) installed to support HNSW indexing. This database extension is a hard requirement to migrate the database and run the app.

 To install pgvector:
 - macOS (Homebrew): brew install pgvector
 - Linux (Debian/Ubuntu): sudo apt install postgresql-15-pgvector (adjust 15 to match your installed PostgreSQL version), or compile from source following the pgvector installation guide.

 Providing a Gemini API key (GEMINI_API_KEY) to actually generate the embeddings i

Top issues

Snapshot: 2026-11-16T23:08:42Z · Data license Apache-2.0 · JSON