0
0
Fork 0
mirror of https://github.com/discourse/discourse.git synced 2026-08-07 13:19:19 +08:00
A platform for community discussion. Free, open, simple. https://www.discourse.org
  • Ruby 58.5%
  • JavaScript 35.5%
  • HTML 3.1%
  • SCSS 2.8%
Find a file
github-actions[bot] 896e810e1b
DEV: Begin development of v2026.3.0-latest (#38083)
Merging this will trigger the creation of a `release/2026.2` branch on
the preceding commit.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-02-26 12:30:48 +00:00
.cursor/rules DEV: update various ai agent configurations (#34192) 2025-08-11 10:08:41 +10:00
.devcontainer DEV: Bump devcontainer image version (#37657) 2026-02-10 16:08:10 +03:00
.github DEV: Switch core system tests to 16-core runners (#37977) 2026-02-23 14:15:38 +08:00
.skills/discourse-upcoming-changes DEV: inits our .skills directory (#37850) 2026-02-17 09:35:23 +11:00
.vscode DEV: Update to latest @glint/ember-tsc (#35337) 2025-10-11 19:40:00 +01:00
.zed DEV: add Zed editor configuration (#36958) 2026-01-06 23:30:45 +01:00
app SECURITY: Prevent TL4 users to post to staff-only categories through a topic timer 2026-02-26 12:22:54 +00:00
bin DEV: Refactor plugin JS handling (#37763) 2026-02-19 12:24:04 +00:00
config SECURITY: harden webooks endpoints 2026-02-26 12:22:54 +00:00
db Revert "DEV: Replace MissingMailgunApiKey check with comprehensive Em… (#38038) 2026-02-24 19:38:30 +00:00
docs FIX: Redirect old data explorer URLs to the new ones (#38004) 2026-02-24 17:50:33 +10:00
frontend SECURITY: XSS when editing a malicious post 2026-02-26 12:22:54 +00:00
images
lib DEV: Begin development of v2026.3.0-latest (#38083) 2026-02-26 12:30:48 +00:00
log
migrations DEV: Replace Ruby numbered parameters by it where applicable (#37810) 2026-02-13 13:59:07 +01:00
patches DEV: Purge the widget rendering system (#36109) 2025-11-26 16:10:02 -03:00
plugins SECURITY: Check for no group assignments in data-explorer queries 2026-02-26 12:22:54 +00:00
public FEATURE: Pin chat messages (#37985) 2026-02-23 22:00:16 +01:00
script DEV: Use new github job.check_run_id workflow expression (#37953) 2026-02-20 16:02:13 +00:00
spec SECURITY: prevent regular users from promoting topics to banners 2026-02-26 12:22:54 +00:00
test DEV: Enable local-storage for smoke test (#34060) 2025-08-04 11:01:09 +01:00
themes UX: styling adjustments for BlogStyle TC in Horizon (#37342) 2026-02-24 11:21:06 +01:00
vendor UX: reposition and restyle translation features to improve experience (#37821) 2026-02-13 13:30:39 -05:00
.annotaterb.yml DEV: Upgrade Rails to version 8.0.2 2025-07-22 09:59:44 +02:00
.editorconfig
.git-blame-ignore-revs DEV: Add route-template change to git-blame-ignore-revs (#35414) 2025-10-27 15:47:48 +00:00
.gitattributes
.gitignore UX: Improve channel context menu "leave" copy (#37230) 2026-01-22 10:42:54 +10:00
.ignore DEV: Hide non-en locale files in IDE search (#31527) 2025-02-26 17:24:03 +00:00
.jsdoc
.licensed.yml DEV: Add Pitchfork alongside Unicorn (#35370) 2025-10-24 11:08:23 +02:00
.licensee.json DEV: Replace 'squoosh' with jSquash for local media optimization (#35248) 2025-10-07 19:31:21 +01:00
.npmrc DEV: prevent pnpm to ask for update (#34808) 2025-09-15 20:11:12 +02:00
.pnpmfile.cjs DEV: Overhaul typechecking configuration (#35794) 2025-11-12 12:54:34 +00:00
.prettierignore DEV: Prepare for rename of app/assets/javascripts/ -> frontend/ 2025-10-22 16:24:11 +01:00
.prettierrc.cjs
.rspec
.rspec_parallel
.rubocop.yml DEV: Resolve RSpec/NamedSubject lint issues in d-ai (#33810) 2025-07-24 13:50:14 +02:00
.ruby-gemset.sample
.streerc DEV: Move discourse-calendar to core (#33570) 2025-07-15 16:38:05 +02:00
.template-lintrc.cjs DEV: Reapply gjs-codemod in d-ai (#33758) 2025-07-23 12:05:40 +02:00
AGENTS.md DEV: update various ai agent configurations (#34192) 2025-08-11 10:08:41 +10:00
AI-AGENTS.md DEV: Document fab! syntax patterns in AI-AGENTS.md (#37260) 2026-01-22 14:02:20 +08:00
Brewfile Add image optimization and utility tools to Brewfile (#35940) 2025-12-16 16:35:19 +11:00
CLAUDE.md DEV: update various ai agent configurations (#34192) 2025-08-11 10:08:41 +10:00
CODEOWNERS DEV: Add Block API for declarative, validated UI extension points (#36810) 2026-02-25 17:36:43 -03:00
config.ru
CONTRIBUTING.md
COPYRIGHT.md
d
discourse.sublime-project
eslint.config.mjs DEV: Update linting and run lttf (#37494) 2026-02-03 20:02:58 +01:00
Gemfile DEV: Bump required Ruby version to 3.4 (#37819) 2026-02-13 17:34:47 +01:00
Gemfile.lock DEV: Bump mini_racer to 0.19.2 (#38031) 2026-02-24 16:36:10 +00:00
GEMINI.md DEV: update various ai agent configurations (#34192) 2025-08-11 10:08:41 +10:00
lefthook.yml FIX: Add syntax_tree to lints and fix-all lefthook hooks (#37258) 2026-01-22 11:14:42 +08:00
LICENSE.txt
package.json DEV: Add Block API for declarative, validated UI extension points (#36810) 2026-02-25 17:36:43 -03:00
pnpm-lock.yaml DEV: Add Block API for declarative, validated UI extension points (#36810) 2026-02-25 17:36:43 -03:00
pnpm-workspace.yaml DEV: Silence pnpm deprecated subdependencies (#37143) 2026-01-15 11:32:41 +00:00
Rakefile
README.md DEV: Bump required Ruby version to 3.4 (#37819) 2026-02-13 17:34:47 +01:00
stylelint.config.mjs DEV: Introduce postcss minmax transform (#31885) 2025-03-18 19:28:52 +00:00
translator.yml DEV: Add discourse-footnote client.yml translator config (#37178) 2026-01-16 15:23:50 +00:00
tsconfig-base.json DEV: Add Block API for declarative, validated UI extension points (#36810) 2026-02-25 17:36:43 -03:00
tsconfig.json DEV: Overhaul typechecking configuration (#35794) 2025-11-12 12:54:34 +00:00
versions.json DEV: Begin development of v2026.3.0-latest (#38083) 2026-02-26 12:30:48 +00:00

The online home for your community.

github-readme

You can self-host Discourse on your own infrastructure. But if you'd rather skip the setup, maintenance, and server management, we offer official Discourse hosting.

👉 Learn more about Discourse hosting

Discourse is a 100% open-source community platform for those who want complete control over how and where their site is run.

Our platform has been battle-tested for over a decade and continues to evolve to meet users needs for a powerful community platform.

With Discourse, you can:

  • 💬 Create discussion topics to foster meaningful conversations.

  • Connect in real-time with built-in chat.

  • 🎨 Customize your experience with an ever-growing selection of official and community themes.

  • 🤖 Enhance your community with plugins, from chatbots powered by Discourse AI to advanced tools like SQL analysis with the Data Explorer plugin.

To learn more, visit discourse.org and join our support community at meta.discourse.org.

Here are just a few of the incredible communities using Discourse:

discourse-communities

👉 Discover more communities using Discourse

Development

To get your environment set up, follow one of the setup guides:

Before you get started, ensure you have the following minimum versions: Ruby 3.4+, PostgreSQL 13, Redis 7.

For more information, check out the Developer Documentation.

Setting up Discourse

If you want to set up a Discourse forum for production use, see our Discourse Install Guide.

If you're looking for official hosting, see discourse.org/pricing.

Requirements

Discourse supports the latest, stable releases of all major browsers and platforms:

Browsers Tablets Phones
Apple Safari iPadOS iOS
Google Chrome Android Android
Microsoft Edge
Mozilla Firefox

Additionally, we aim to support Safari on iOS 16.4+.

Built With

  • Ruby on Rails — Our back end API is a Rails app. It responds to requests RESTfully in JSON.
  • Ember.js — Our front end is an Ember.js app that communicates with the Rails API.
  • PostgreSQL — Our main data store is in Postgres.
  • Redis — We use Redis as a cache and for transient data.
  • BrowserStack — We use BrowserStack to test on real devices and browsers.

Plus lots of Ruby Gems, a complete list of which is at /main/Gemfile.

Contributing

Build Status

Discourse is 100% free and open source. We encourage and support an active, healthy community that accepts contributions from the public including you!

Before contributing to Discourse:

  1. Please read the complete mission statements on discourse.org. Yes we actually believe this stuff; you should too.
  2. Read and sign the Electronic Discourse Forums Contribution License Agreement.
  3. Dig into CONTRIBUTING.MD, which covers submitting bugs, requesting new features, preparing your code for a pull request, etc.
  4. Always strive to collaborate with mutual respect.
  5. Not sure what to work on? We've got some ideas.

We look forward to seeing your pull requests!

Security

We take security very seriously at Discourse; all our code is 100% open source and peer reviewed. Please read our security guide for an overview of security measures in Discourse, or if you wish to report a security issue.

Security fixes are listed in the release notes for each version.

The Discourse Team

The original Discourse code contributors can be found in AUTHORS.MD. For a complete list of the many individuals that contributed to the design and implementation of Discourse, please refer to the official Discourse blog and GitHub's list of contributors.

Copyright 2014 - 2025 Civilized Discourse Construction Kit, Inc.

Licensed under the GNU General Public License Version 2.0 (or later); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Discourse logo and “Discourse Forum” ®, Civilized Discourse Construction Kit, Inc.

Accessibility

To guide our ongoing effort to build accessible software we follow the W3Cs Web Content Accessibility Guidelines (WCAG). If you'd like to report an accessibility issue that makes it difficult for you to use Discourse, email accessibility@discourse.org. For more information visit discourse.org/accessibility.

Dedication

Discourse is built with love, Internet style.

For over a decade, our amazing community has helped shape Discourse into what it is today. Your support, feedback, and contributions have been invaluable in making Discourse a powerful and versatile platform.

Were deeply grateful for every feature request, bug report, and discussion that has driven Discourse forward. Thank you for being a part of this journey—we couldnt have done it without you!