1.7 KiB
1.7 KiB
Damus Web
Here lies the code for the Damus web app, a client for the Nostr protocol. The goal of this client is to be a better version of Twitter, but not to reproduce all of it's functionality.
Contribution Guide
There are rules to contributing to this client. Please ensure you read them before making changes and supplying patch notes.
- No transpilers. All source code should work out of the box.
- Keep source code organised. Refer to the folder structure. If you have a question, ask it.
- Do not include your personal tools in the source code. Use your own scripts outside of the project. This does not include build tools such as Make.
- Use tabs & write JS with snake_case. End of discussion.
- Do not include binary files.
- No NPM (and kin) environments. If you need a file from an external resource mark the location in the "sources" file and add it to the repo.
- No frameworks. Learn the browser tools and write good code.
- No experimental browser APIs.
- Do not write animations in JavaScript, CSS only. Keep them short and snappy. Animations should not be a forefront, but an enjoyable addition.
- All new & modified code should be properly documented.
- Source code should be readable in the browser.
These rules are subject to discussion.
Terminology
- Sign Out - Not "log out", "logout", "log off", etc.
- Sign In - Not "login", "log in", "signin", "sign-in", etc.
- Share - Not "boosted", "retweeted", "repost", etc.
- Send - Not "tweet", "toot", "post", etc.
- Link - Not "share".
Known Issues
- You cannot send events when running from an IP address that is not secure. Work arounds are not known at this time.