A Node.js based forum software
Go to file
Akif9748 cf8de73e7c Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
models Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
public Better markdown editor for create_thread 2022-09-23 23:20:00 +03:00
routes Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
util Better reset 2022-09-17 15:19:41 +03:00
views Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
.env.example Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
.gitignore Added discord auth support 2022-09-17 19:33:51 +03:00
APIDOCS.md Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
LICENSE Server side license 2022-08-28 15:45:19 +03:00
README.md Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
config.json.example Major update named as minor! 2022-09-23 23:10:13 +03:00
index.js Added unauth w/discord, and better auth 2022-09-24 00:15:17 +03:00
lib.js Major update named as minor! 2022-09-23 23:10:13 +03:00
package-lock.json 4.17.0 2022-09-23 23:10:22 +03:00
package.json 4.17.0 2022-09-23 23:10:22 +03:00

README.md

akf-forum

A Node.js based forum software.

Installation

  • Clone or download this repo.
  • Run npm i to install dependencies.
  • Enter your database credentials in .env.
  • Run npm start for run it.
  • Go /setup page for setup your forum.

Extra (If you are not use setup page)

Run node util/reset to reset the database for duplicate key errors, and run node util/admin for give admin perms to first member. Edit config.json for default themes (black or default) of users, and forum name, meta description, character limits, discord auth enabler, global ratelimit.

DISCORD AUTH:

"discord_auth": "your_app_id" in config.json. Add your app secret to .env as DISCORD_SECRET. Create a redirect url in discord developer portal: https://forum_url.com/discord_auth/hash

API

Akf-forum has got an API for AJAX (fetch), other clients etc. And, you can learn about API in APIDOCS.md.

And you can use offical API wrapper.

Credits

  • Akif9748 - Project mainteiner, main developer, made old frontend
  • Tokmak - Made new frontend
  • Camroku - Made old stylesheets

Screenshot

Thread Page w/Black Theme

black-theme

Threads Page w/Default Theme

light-theme

Mobile view

TO-DO list

  • Profile Message or DM
  • mod role, permissions
  • upload other photos, model for it
  • categories page is need a update, thread count in category
  • Disable last seen button for web.
  • email auth.
  • old contents / titles add to forum interface
  • add ban button to user profile.
  • change password.
  • add approval threads page.
  • who liked a message for web.
  • edit config from web admin panel.

Major Version History

  • V4: Caching
  • V3: New Theme
  • V2: Backend fix, mongoose is fixed. Really big fix.
  • V1: Mongoose added.
  • V0: Birth with quick.db