pingpad-io / ping

minimalistic decentralized social

Overview

what?

pingpad is a minimalistic decentralized social platform, made for you and your community.

why?

clarity paves the way for brilliance. pingpad is focusing on clear and efficient solutions.

how?

built on top of lens network, media is shared using ipfs and backed up on arweave

Gallery

Contributing

Thank you for considering contributing to Pingpad!

First, you need to fork and the repository:

git clone https://github.com/pingpad-io/ping.git && cd ping

After that, follow the steps to run Pingpad on your local machine:

1. Create a .env file

Copy the provided .env.example file to .env.

cp .env.example .env

2. Install dependencies

Use npm to install dependencies.

npm install

3. Running the dev server

Finally, you can run the dev server:

npm run dev

and navigate to http://localhost:3000/home

4. You're awesome!

Now you're all set to start contributing to Pingpad! Next, read contributing.md

5. (extra) Install Biome

Biome is used for formatting and linting in the project, and can be installed in the VSCode extension marketplace or on biome website

ping's Issues

[bug] disable reactions for non-authed users

Description
reactions underneath the post (repost, like, collect, bookmark) should not be intractable, unless the user is authenticated

[feat] add open frames

Feature description
implement the open frames standard

[feat] add posting

Feature description
add posting in-feed and in-modal (menu post button)

Is this feature request related to a problem?
Pingpad is currently read-only, we need to implement poasting

[feat] context menu enchancements

Feature description
depending on the context add:

• text copy
• text translation
• (quote) in reply
• copy media link
• copy image
• back / forward router
• reload page

[feat] add reactions

Feature description
we need to add interactivity to existing reactions:

• like,
• repost,
• comment,
• collect,
• bookmark

Is this feature request related to a problem?
currently all reactions are read-only

Possible solutions
add our own apis and use lens client inside of them

[feat] follow/unfollow a profile

Feature description
add follow/unfollow button to the user profile, post context menu and sidebar

[feat] OG images

Feature description
add OG images to posts and profiles

Possible solutions
og image must show the content of the post with poster handle and a pingpad logo

[feat] add follows you notification

Feature description
add follows you on user profile and user card

[feat] comment view improvements

Feature description
comments on a post page must show reply trees and load recursively.
the comments must hot show replied to field and must have a line that connects them together

Possible solutions
pass a new prop into PostView or create a separate CommentView

[feat] add handle parsing

Feature description
parse and replace @ handles in markdown text into actual links to profiles, additionally parse @ lens/handles too

[feat] new navigation

Feature description
Replace tabs for For you, Best, and Explore pages with circles, add community circles later on

Is this feature request related to a problem?
Twitter-like tabs just kinda look bad

[feat] display user interests

Feature description
display user interests on the profile page in a neat scrollable popover

[feat] communities

Feature description
add a sidebar panel with communities overview, including existing orb clubs

Possible solutions
filter the fetch request metadata to get posts from a certain community

[bug] fix profile pictures for unsupported formats

Description
Avatar images use fallback when user is using .gif (and probably other formats)

Screenshots

Possible solutions
Make avatar fallback to another component, then fall back to default letters

[feat] native handle minting

Feature description
add possibility to mint a handle without leaving pingpad

Is this feature request related to a problem?
currently the "+ New Profile" just links to the lens.xyz page where user can mint a handle

Possible solutions
there are apis in the lens client available for it

[bug] fix previews on video player

Description
there are two issues right now:

1. the video previews are not being shown (mostly due to lens bigq returning the same link for the preview as for the video)
2. once clicked, video dimensions must not jump as it loads

[feat] add community explorer view

a separate page with available communities. can hardcode for now?

[feat] add effects to follow and like butotns

Feature description
add a little confetti effect to make it feel nice

[feat] display communities in posts

Feature description
add community name and (optional) logo rendering to the post info view.

[feat] add in-feed comments

Feature description
a few most interesting comments must show underneath the post in-feed, without clicking and referring to the post page

Possible solutions
filter for 1 most popular comment + comments from people you follow?

[feat] render all attached images in the post

Feature description
add a gallery view that would display all of the attachments of the post

[feat] implement missing metadata components

Feature description
currently implemented text only, photo and video metadata types, need to complete components for all other ones lens protocol is exposing in the same manner

[feat] add handle autocomplete

Feature description
a nice popup that helps you find the right handle as you type

[feat] show amount of unread notifications in the menu

Feature description
add a ticker with a number of unread notifications by the user

Possible solutions
store last viewed notification id in the memory and parse new notifications on each focus change

[feat] add volume slider

Feature description
add volume mute/unmute button + a slider to the embedded video player

[feat] profile tabs

Feature description
Add profile tabs that would show different types of posts of an individual

Possible solutions
we can make it into a post/reply/quote tab split or a dropdown where you choose the type of content a person wants, up to the assignee

[feat] add expand button

Feature description
currently posts are truncated and ... is added at the end, need to also show expandable posts with a button

[feat] add follow/unfollow buttons

Feature description
add follow buttons to the user profiles

[feat] display comments in feed view

Feature description
related to #31, fetch and display existing comments under posts in feed.
prioritize users follows and 1 most engaged comment is a good default

[feat] show subscribtions on profile page

Feature description
Add subscribed/subscribers counter to the profile page, add user list view

[feat] community creation

Feature description
Add a create community button to communities tab

Possible solutions
perhaps a persistent cache is needed for this one until communities are on-chain, need to investigate

[feat] add repost button menu

Feature description
when user presses on repost button, draw a menu with options

• repost
• quote
• (if reposted) undo repost

[feat] create debug api endpoints

Feature description
add endpoints to easily query lens-specific and ping-specific metadata and object structures

[feat] add music player

Feature description
cook up a separate music player for .mp3 files

Possible solutions
the same player we use for videos can be used

[feat] add emojis

Feature description
add better emoji rendering and emoji menu in the post wizard

[feat] add comments

Feature description
Inline post wizard under each comment section to allow users to post comments.
additionally, pressing the comment button should not take user to the post view, but rather load the comments inside the current feed

[feat] add fullscreen image viewer

Feature description
images should be expandable just like videos are, screenfull can be used for that as well. make a fullscreen viewer consistent across videos, images and music