Create an awesome list for Fedify

[nyeong]

I'd like to create an awesome list to:

• Gather real-world Fedify examples
• Gather resources or articles like tutorials
• Help users discover existing projects for inspiration

Proposed Structure

• Services
  • Ghost
  • Hollo
  • Hackers'Pub
  • ...
• Frameworks
  • BotKit
  • ...
• Tutorials
  • ...
• Videos, Talks
  • ...

For Discussion

1. Languages

   Many articles are written in Korean. How should we label them?

2. Inclusion Criteria

   What criteria should we use to determine which projects/articles to include?

3. Category selection criteria

   Are the current categories sufficient?

[nyeong]

If this proposal is okay, I'd be happy to write more concrete details.

[notJoon]

1. Languages
   Many articles are written in Korean. How should we label them?

How about adding labels like [KO], [EN] or flags to project names? Also, adding sentences like "Korean tutorials for ..." in the description section seems considerable.

2. Inclusion Criteria
   What criteria should we use to determine which projects/articles to include?

Criteria based on minimum star ratings and licensing requirements will be good starting points. whether they're actually used in the community could also serve as a metric

3. Category selection criteria
   Are the current categories sufficient?

The current category structure looks fine. I think it would be better to update this incrementally over time.

[dahlia]

Looks fine in general!

1. Languages: Actually, many resources are written in Korean and Japanese. I think we could label them like below:

   • 우리의 코드를 찾아서 – 2막. 민희님과 Fedify & Hollo 알아보기 (한국어, 日本語字幕)

2. Projects: I think it's okay to include projects under @fedify-dev org. For Hackers' Pub… I think it's okay for some categories (e.g., “Success stories”).

3. Categories: How about “Examples”?

[nyeong]

Great. Let's start with official projects and articles like:

## Services
- [Hollo](https://github.com/fedify-dev/hollo) - Federated single-user microblogging software
- [Hackers' Pub](https://github.com/hackers-pub/hackerspub) - ActivityPub-enabled social network for hackers

## Libraries
- [BotKit](https://github.com/fedify-dev/botkit) - A framework for creating ActivityPub bots

## Examples
- [microblog](https://github.com/fedify-dev/microblog) - A simple federated microblog example using Fedify for educational purpose

## Tutorials and Resources
- [Creating your own federated microblog](https://fedify.dev/tutorial/microblog) (English, 한국어, 日本語)
- [OSSCA: Fedify 프로젝트 기여자들을 위한 안내](https://hackers.pub/@hongminhee/2025/ossca-fedify-contributors-guide) (한국어)
- [BotKit 시작하기](https://velog.io/@hongminhee/getting-started-with-botkit) (BotKit, 한국어)
- [Fedify DeepWiki](https://deepwiki.com/fedify-dev/fedify)

## Talks
- [우리의 코드를 찾아서 – 2막. 민희님과 Fedify & Hollo 알아보기](https://www.youtube.com/watch?v=sqxR8zscSDo) (한국어, 日本語字幕)

Ghost for ActivePub looks heavily under construction so I've removed that.

[malkoG]

We can also be inspired by this page. We can see what projects are actually using @fedify/fedify

https://github.com/fedify-dev/fedify/network/dependents?dependents_before=Mzg2NzI5ODE5MDY&package_id=UGFja2FnZS00NzE4NjI4MTM3

[ssuminii]

I'd like to take it.

[dahlia]

Here's another talk on Fedify (Japanese): FedifyでActivityPubサーバを作ってみた.

[tysoncung]

I've created an initial awesome-fedify list! 🎉

Repository: https://github.com/tysoncung/awesome-fedify

The list includes:

• 11 comprehensive categories
• Official resources and documentation
• Templates & boilerplates section
• Example applications
• Middleware & integrations
• Tools & utilities
• Tutorials & guides
• Community projects
• Articles, videos, and community resources

I've structured it following the awesome list guidelines with proper badges, contributing guidelines, and code of conduct. Happy to collaborate with the community to expand and improve it!

Would love your feedback and suggestions for additional resources to include.

[dahlia]

@tysoncung Thank you for taking the initiative to create an awesome-fedify list! However, I noticed that most of the links in the repository are pointing to non-existent projects.

For example, these repositories don't actually exist:

• fedify-dev/fedify-express-template
• fedify-dev/fedify-blog-example
• fedify-dev/fedify-cli
• fedify-dev/fedikit
• The Discord and Reddit community links also appear to be invalid

The actual fedify-dev organization only has these main projects:

• fedify (main library)
• hollo (microblogging platform)
• botkit (bot framework)
• microblog (example)
• fedichatbot (LLM chatbot demo)

It would be great if you could update the list with real, existing resources. You can find actual projects using Fedify here: https://github.com/fedify-dev/fedify/network/dependents

Since we've assigned this issue to @ssuminii to create an official awesome list, perhaps you two could collaborate? The fedify-dev organization already has an empty awesome-fedify repository that could be used for the official list.

[tysoncung]

Thank you for the detailed response! I really appreciate you taking the time to explain the current documentation structure.

I understand your point about the API reference being comprehensive. After reviewing it more carefully, I can see it does cover the technical details well. You're right that adding redundant information wouldn't be helpful.

I'd be happy to help improve the documentation in ways that would be most valuable. Based on your feedback, perhaps I could focus on:

• Practical examples or tutorials showing common use cases
• Integration guides for popular frameworks
• Best practices for ActivityPub implementation using Fedify

Would any of these areas be helpful? I'm also open to other suggestions where documentation contributions would add the most value.

Thanks again for maintaining this great framework! 🚀

[github-actions[bot]]

@ssuminii This issue has been assigned for over two weeks without updates. Please provide a status update, or unassign yourself if you're unable to continue working on it.

[github-actions[bot]]

@ssuminii This issue has been assigned for over two weeks without updates. Please provide a status update, or unassign yourself if you're unable to continue working on it.