Useful links

Dependencies

Want to learn more about one of the dependencies we use? Look no further!

• Flask https://flask.palletsprojects.com/en/stable/
• Google Oauth https://console.cloud.google.com/apis/credentials?authuser=6&project=twidilers&supportedpurview=project
• Github Oauth https://github.com/settings/applications/2831103

Good tutorial sources

• https://blog.miguelgrinberg.com/category/Flask

HOW BRANCHES WORK

Okay so it's looking a little bit different now! For each release, create a new branch with that release name. So, if I was doing something small without adding a feature I may make a branch called v1.6.1. For example, I might make the styling more mobile friendly or fix a typo. Once a "release" is done, send a pull request to beta-stable, which is then tested one final time and then merged into release.

I don't want to create a new release for every little thing, so try to collect them before release. It reduces the amount of reviews and redeployments.

Also make sure to plan out ahead, by creating "issues" for bugs or features and then attaching your improvements to that as a "milestone"

State of pages

Feed

Redid in v1.2.

Settings

Flyout styling

I don't know how this would work but an option to switch between the different flyout styles

Notification

Add notification settings. Hopefully this would include adding a settings JSON part of the account table, and we can redo the settings page with API calls -E

DMs

If derin wants to work on this sure but i don't see this as high priority -E

Cool general feature ideas

Settings

• Redo settings into different templates
• Add notification settings
• Appearance preferances, changing the flyout style and default feed setting

User accounts

New user setup process

• User 404 page when not fully setup
• Ability to resend verification link

Login process

• "Stay signed in" button. Otherwise, automatically sign out after a week.
• Able to log in with either username or email

Oauth

• passkeys?

User API

• User-side API which allows users to post from outside of Twidilers.com (Would be cool to get some bots setup to make it look like there is activity)

Moderation tools

Ability for admin03 to ban/delete user accounts

Email requirements

When we'd send emails

• When changing user settings (like a password, email address)
• When creating an account
• Signing in from a new device (opt-in by user)
• Notification digest (Set up by user)
• Newsletter (opt-in by user)

required enviromental variables

• FLASK_SECRET_KEY (is auto-generated if not present, but create if you want session persistence)
• FLASK_MAIL_SERVER (for which mail server to send messages from)
• FLASK_MAIL_USERNAME (the username to log into the mail server)
• FLASK_MAIL_PASSWORD (the password for that user)
• FLASK_MAIL_DEFAULT_SENDER (what address to send messages from, e.g. 'noreply@twidilers.com')

How does flask-migrate work?

To update your database

• Don't "Delete pData"
• Instead run: docker compose exec web flask --app 'twidilers:create_app()' db upgrade

When modifying the db models

• Don't just edit the models then try to upgrade. You need a migration script.
• To generate a migration script: docker compose exec web flask --app 'twidilers:create_app()' db migrate -m "Migration Message Here"
• THEN upgrade your db

Far out features

• Passkeys to store login information
• Search function
• Algorithmic feed that prefers newer posts by people you follow/interact with
  • Newness weight
  • Weight for the poster (Have you interacted with their posts recently (negetively or positively), do you follow them)
• Blocking feature. Example: Alice blocks Bob. Bob can't see Alice's posts.
• Hiding feature. Example: Alice hides Bob. Alice can't see Bob's posts anymore.