ArabDev 1.4.0

Latest

What is new in 1.4

  • newOpen Make it yours from the palette icon, including as a guest. Choose an accent, Tajawal, Alexandria or your device font, text size 14–20, and a plain, dotted, grid or gradient background. Choose compact cards and a wider reader too. Choices persist locally and sync with your account.
  • newExplore separates latest posts, trending and editorial picks. Trending has explicit week, month or all-time ranges. Filter by type, language and unanswered questions. Projects and Developers have their own pages. Followed topics improve For you.
  • newPublish an article, question, project or note. Projects can include repository and demo URLs; organize posts into numbered series from My series. Drafts autosave after a pause, with a local recovery per account and document. A conflict between tabs stops saving: copy your edits or keep recovery and reload to compare. Editing a published post never publishes automatically.
  • improvedUse the table of contents, copy highlighted code, and open full images. Question authors can accept an answer. Organize bookmarks into collections with private notes; deleting a collection keeps saved posts. Account exports include this data.
  • newGitHub sign-in appears when configured by the operator. Matching email addresses never link accounts automatically: sign in normally, then link GitHub in Security settings after confirming your password. Two-factor verification still applies. New GitHub accounts receive a generated username and can set a password through email password reset.
  • securityThe weekly digest is opt-in and disabled by default for operators. When enabled, subscribe in Notifications; each message includes an unsubscribe confirmation link. Auto-hide counts reports from verified accounts at least seven days old that are not restricted, excluding accounts with three dismissed reports in 90 days. Every report remains available for review.

ArabDev 1.3.2

Until now a bot needed a real browser only to sign in, post and comment. Now it needs one for everything an account can change, and new accounts get limits that make spam slow and easy to spot. Nothing changes for people: the extra check runs in the background.

A check behind every action

  • SecurityLikes, saves, reposts, follows, blocks, reports, uploads, drafts, edits, deletions and profile changes now need a Turnstile check too. It runs in the background about once every 30 minutes, so people don't see it, and a script holding a stolen or bot-made session can't do any of these.
  • SecurityThe check is traded for a signed pass that works for one account only, lasts 30 minutes and is cancelled by signing out everywhere or changing the password. It can't be used to sign in.
  • ImprovedWhen the pass has run out, the app gets a new one and repeats the request on its own, so a like or a follow never fails because of it.

Spam and malware

  • SecurityDuring its first day an account can publish 5 posts and 20 comments an hour, and add up to 2 links to a post, a comment or its bio.
  • SecurityNew accounts can't link straight to programs to download (.exe, .apk, .msi and similar) or to bare IP addresses, the usual ways malware is passed around. Links to a project's page or its releases still work.
  • NewThe same post twice within a day is refused, and so is the same comment, unless it is a short one like "Thanks!".
  • SecuritySign-ups and email changes to temporary inboxes (Mailinator, 10 Minute Mail, Guerrilla Mail, YOPmail and about 90 others) are refused.
  • SecurityThe sign-up form has a field people never see. Bots that fill in every field fill that one too, and are turned away.

Hardening

  • SecurityAPI answers and uploaded images are sent with a Content-Security-Policy that lets them load and run nothing, and with Cross-Origin-Resource-Policy, so they can't be turned into pages or pulled into other sites.
  • ImprovedChecked for SQL injection: every database query goes through SQLAlchemy with bound parameters, and search patterns are escaped. New tests send injection attempts to search, sign-in, profiles and tag feeds, and check that the data is untouched.

For developers

  • Developerapp/services/human_check.py issues the pass and provides RequireHuman, now on 24 routes; a new route that changes something should use it or a Turnstile guard of its own. New endpoint POST /api/v1/users/me/human-check and header X-ArabDev-Human; without Turnstile keys the check is skipped.
  • Developerapp/services/spam_guard.py holds the new-account limits, duplicate checks, the disposable-domain list and the honeypot. New error codes: human_check_required, too_many_links, risky_link, duplicate_post, duplicate_comment, email_disposable and request_rejected.
  • DeveloperThe test helper make_post writes different text for each post, since identical posts are now refused. The backend has 137 tests.

ArabDev 1.3.1

Google was the only search engine that knew ArabDev's pages. Bing, and with it DuckDuckGo, Yahoo and Ecosia, had found just one address, and a sign-in screen at that. ArabDev now tells those engines about posts as they are published, and stops them from listing pages that only make sense once you're signed in.

For developers

  • Developerapp/services/indexnow.py sends the addresses after the response, so publishing doesn't wait for it, and a failure is only logged. The key file is served at /<key>.txt; the key is derived from SECRET_KEY, so there is nothing new to configure.
  • DeveloperNew setting INDEXNOW_ENABLED (on in production, off elsewhere) and command python -m app.cli indexnow, which sends every address in the sitemap. vercel.json and nginx.conf route the key file and add X-Robots-Tag: noindex to signed-in pages. The backend has 117 tests.

ArabDev 1.3.0

You can now sign in with an authenticator app and block people, passwords that have leaked in other sites' breaches are refused, and every profile and tag has an RSS feed. The homepage and the three documentation sites were rebuilt to look like the rest of the app, and the code got the checks contributors expect.

Authenticator app

  • NewYou can add an authenticator app to your account under Settings → Security. Enter your password, scan the QR code with Google Authenticator, Microsoft Authenticator, 1Password or any app that makes six-digit codes (or type the key by hand), and confirm with the first code it shows.
  • NewWith the app turned on, signing in asks for a code from the app after your password, instead of the code we would otherwise email you. You get five tries, as with emailed codes.
  • NewTurning it on gives you ten recovery codes, shown once. Each one signs you in once if you lose your phone. Settings shows how many are left and can make a new set, which cancels the old one.
  • SecurityThe app's secret key is stored encrypted, and recovery codes only as hashes. Each code from the app works once: a code that has already signed you in is refused, even inside its 30 seconds.
  • SecurityWith account alerts on (the default), you get an email when the app is turned on or off, when a recovery code is used (with how many are left), and when a new set of recovery codes is made. Turning the app off needs your password and a code.

Leaked passwords

  • SecurityA new password is checked against Have I Been Pwned's list of passwords from public data breaches when you sign up, reset your password or change it, and refused if it is on the list. Only the first five characters of the password's SHA-1 hash are sent, never the password. If the list can't be reached, the password is accepted, so an outage doesn't lock anyone out.

Blocking

  • NewYou can block an account from the ⋯ menu on its profile or on any of its posts.
  • NewOnce you block someone, neither of you can follow, comment on, reply to or repost the other, and nothing sends a notification across the block. You stop seeing their posts, comments and suggestions. They aren't told.
  • NewBlocking removes the follows between you in both directions, and the notifications they had sent you.
  • NewSettings → Privacy lists the accounts you blocked, each with an Unblock button, and the data download includes them.

RSS feeds

  • NewRSS feeds for the latest posts (arabdev.site/rss.xml), for each profile (/u/username/rss.xml) and for each tag (/tags/name/rss.xml). A profile's ⋯ menu links to its feed, and pages announce their feed so a reader can find it on its own.
  • ImprovedAccounts that switched off Show me in search and suggestions have no feed.

Homepage

  • ImprovedThe homepage is rebuilt from the app's own parts: the same top bar, post cards and popular tags as the dashboard, and the dark panel from the sign-in page. It used to have a separate design of its own.
  • NewThe drawing of a laptop is replaced by a picture of the real dashboard on a MacBook, in your language and in light or dark to match your settings.
  • ImprovedThe three latest posts are shown as full post cards, and the text was rewritten to say plainly what the site is.

Ads

  • ImprovedGoogle ads have fixed places: one or two on the homepage (the 728×90 banner only on wide screens), in the feed after the 3rd, 9th and 15th post of a page, one in the sidebar, and one between a post and its comments.
  • ImprovedGoogle ads are labelled Advertisement. When Google has no ad for a place, the space goes to one of ArabDev's own sponsor cards or closes up, instead of staying empty.

The wiki, privacy policy and patch notes

  • ImprovedAll three now look like the app: the same top bar, navigation column, cards and side column, in light and dark.
  • ImprovedThe wiki's main page is rewritten, and the articles describe 1.3.0: the authenticator app, blocking, RSS and where ads appear.
  • ImprovedThe privacy policy (version 1.5) covers the authenticator app, recovery codes, blocks and the leaked-password check.
  • ImprovedText across the app is rewritten in plainer words: the panel beside the sign-in form, empty pages, some settings, and the About page.

Fixes

  • FixedPopular tags counted posts that were hidden, so a tag could look popular because of posts nobody can see.
  • FixedAfter Send another code, the countdown before the next resend didn't restart.
  • FixedSigned-out visitors no longer see a brief loading screen first.
  • SecurityWhen it couldn't reach Redis, the server wrote Redis's full address, password included, to its logs. It writes the host name only now. It also waits 2 seconds to connect instead of 0.5, which cold starts on Vercel needed.
  • SecurityPyJWT is now 2.15 or newer and DOMPurify 3.4.17, both past published security advisories.

For developers

  • DeveloperThe backend is checked and formatted by Ruff (style, imports, likely bugs and bandit's security rules), and pip-audit checks its dependencies. The frontend is checked by oxlint and Prettier, and npm audit checks its runtime dependencies. CI runs all of them.
  • DeveloperNew tables blocks and recovery_codes, and three columns on users (totp_secret, totp_enabled_at, totp_last_step), in migration 7a44454d249f. Run alembic upgrade head.
  • DeveloperNew endpoints: POST /api/v1/users/me/two-factor/setup, /enable, /disable and /recovery-codes; GET /api/v1/users/me/blocked; POST and DELETE /api/v1/users/{id}/block. Signing in can now answer with a login_2fa challenge.
  • DeveloperNew setting PWNED_PASSWORDS_ENABLED (on by default; the tests turn it off) and new dependencies cryptography and segno. The VITE_ADSENSE_* build settings are gone: the ad units live in frontend/src/site.ts.
  • DeveloperSettings and the moderation page are split into one file per part under frontend/src/features/. The repository has a new README, CONTRIBUTING.md, a code of conduct, issue and pull request templates, and an .editorconfig. The backend has 111 tests.

ArabDev 1.2.1

Public pages can now be read without JavaScript, the homepage shows the latest posts, and there are new About and Contact pages.

Readable by everyone, and everything

  • ImprovedPosts, profiles, tags and Explore now arrive with their own title, description and text already in the page. Search engines, ad reviewers and link previews that do not run JavaScript used to receive an empty page with the homepage's title.
  • ImprovedSharing a post in a chat app or on a social network now shows that post's title, summary and image instead of the homepage's.
  • ImprovedThe homepage carries its own text from the first byte as well. Nothing changes for readers: the app starts as before and takes over the page.
  • FixedA post that does not exist, is hidden for review or belongs to a suspended account now answers “not found” and asks search engines not to list it, instead of answering as if it were there.
  • FixedThe sitemap no longer lists posts that are hidden for review or belong to suspended accounts.

Homepage

  • NewThe homepage now shows the six latest posts from the community, so visitors can see what people are writing, and start reading, before creating an account.

About and Contact

  • NewA new About page at arabdev.site/about: why ArabDev exists, what you can do on it, who runs it, how it is paid for and how it is moderated.
  • NewA new Contact page at arabdev.site/contact: both addresses, what each is for, what to include, and when to expect an answer.
  • ImprovedBoth pages are linked from every footer and listed in the sitemap.

Privacy

  • ImprovedPublic pages are now kept by our hosting for a few minutes to answer quickly, so an edited or deleted post can remain visible at its address for up to about ten minutes. The privacy policy (version 1.4) says so.
  • ImprovedAccounts that switched off Show me in search and suggestions are left out: their profile page is sent without their name or posts written into it.

For developers

  • Developerapp/services/page_service.py writes a page's head and text into the built app shell, and app/api/pages.py serves /posts/{id}, /u/{username}, /tags/{slug} and /explore from the site root. Text is built from plain text and escaped, never from stored HTML.
  • DeveloperThe frontend build now ends with scripts/prerender.mjs, which writes the homepage, /about and /contact from the translation files and emits app.html, the untouched shell every other address falls back to.
  • DeveloperNew settings SPA_SHELL_URL and SPA_SHELL_PATH tell the API where to read that shell. vercel.json, nginx.conf and docker-compose.yml route the new pages. The backend test suite now has 95 tests.

ArabDev 1.2.0

Anyone can now report a post, and moderators can keep it, remove it, or restrict or suspend its author, with each step emailed to the people involved. The For you feed and the Trending list are ranked differently, and the emails were redesigned.

  • ReportingPick a reason, add a few words if you like, and the moderators get it.
  • DecisionsKeep the post, remove it, stop the author publishing for a set time, or suspend the account. Everyone involved gets an email.
  • For youRanked by who you follow, the topics you picked, how much discussion a post starts and how new it is.
  • EmailsThey use the ArabDev wordmark and the site's fonts.

Reporting posts

  • NewEvery post now has Report post in its ⋯ menu. Pick one of nine reasons (spam, harassment, hate speech, sexual content, violence, misinformation, private information, copyright or something else) and add details if you like.
  • NewThe author is emailed that their post was reported and why, but never by whom. The ArabDev team is emailed the details with a button that opens the report.
  • NewWhen three different people report the same post, it is hidden from everyone but its author and the moderators until the team decides. The author sees a notice on the post.
  • SecurityReporting the same post twice counts once, you cannot report your own posts, and each account can send at most 20 reports a day, so the button cannot be used to bury someone.

Moderation

  • NewA new Reports page for moderators groups every open report on a post into one case, with the post, its author, each reason and the reporters' notes.
  • NewA moderator can keep the post, remove it, stop its author publishing for 1 to 365 days, or suspend the account, and add a note for the author. The author and every reporter are emailed the outcome.
  • NewRestricted members can still read, like and save, and see until when they cannot post, comment or repost at the top of every page. Suspended accounts are signed out everywhere and their posts disappear from every list.
  • NewModerators see past decisions and every restricted or suspended account, and can lift a restriction early.

For you and Trending

  • ImprovedFor you now scores each recent post by how close it is to you (people you follow, your interests, authors you like or comment on, and what people you follow liked or reposted), how much discussion it started, and how fresh it is.
  • ImprovedFor you mixes authors: the first five posts never hold more than two from the same person, and your own posts and ones you already liked move down a little.
  • ImprovedTrending this week now ranks by how fast a post is gathering reactions rather than by totals alone, so a new post that is taking off can pass an older one.

Emails

  • ImprovedEvery email has a new look: the ArabDev wordmark in Anton at the top, headings in Alexandria and text in Tajawal, in both Arabic and English.
  • ImprovedThe wordmark is an image, so it looks the same in every mail app. Apps that do not load web fonts, such as Gmail, fall back to a clean system font.

Privacy and safety

  • SecurityA post hidden for review cannot be opened, liked, commented on or reposted by anyone except its author and the moderators.
  • ImprovedDownload my data now includes the reports you sent. Reports about your posts are left out, because they would reveal who sent them.
  • ImprovedDecided reports are deleted automatically after 12 months. The privacy policy (version 1.3) explains what a report stores and who can see it.

For developers

  • DeveloperNew endpoints: POST /posts/{id}/report, and for moderators /admin/summary, /admin/reports, /admin/reports/{id}/decision, /admin/restricted and /admin/users/{id}/lift. Posts carry under_review, and /users/me carries restricted_until.
  • DeveloperNew settings: ADMIN_USERNAMES (moderators by username), MODERATION_EMAIL, REPORT_AUTO_HIDE_THRESHOLD (3) and REPORT_RETENTION_DAYS (365). A new migration adds the reports table and the restriction columns.
  • DeveloperFeed ranking moved to app/services/ranking.py, with every weight named and explained. The backend test suite now has 87 tests.

ArabDev 1.1.1

Rate limits now hold across every server and can't be dodged, every page sends security headers, image uploads are checked more strictly, search engines can index the pages, and the editor's code no longer loads on pages that don't use it.

Security

  • SecurityRate limits now count the address our hosting recorded for each request, not the one the visitor’s browser claims, so a forged X-Forwarded-For header no longer buys unlimited sign-in, sign-up or reset attempts.
  • SecurityRate-limit counters are now shared by all of ArabDev’s servers through Redis, instead of each server counting on its own, so the limits hold at their stated values.
  • SecurityEach inbox receives at most five password reset emails an hour, however many networks ask for them.
  • SecurityDeleting your account now shares the password-guess limit that changing your email and password already had: ten tries every fifteen minutes.
  • SecurityUploaded images are measured from their file header and refused before being decoded when they are too large, so a small file can no longer expand into hundreds of megabytes of memory.
  • SecurityEvery page is now sent with security headers: HTTPS is enforced (HSTS), no other site can show ArabDev inside a frame, plugins and forms that post elsewhere are blocked, and camera, microphone, location and payment access are switched off.
  • SecurityThe server refuses to start in production with a missing signing key or one of the published placeholder keys.

Performance

  • ImprovedThe post editor (about 137 KB compressed) is no longer downloaded on every page. It now loads only when you open the editor, so the homepage, feed and posts open faster, especially on phones.

Running the service

  • ImprovedEmails, including sign-in codes, security alerts and password reset links, are now delivered from noreply@arabdev.site.
  • Improvedarabdev.site is now the one address of the site; the old www address has been retired.

For developers

  • DeveloperNew setting TRUSTED_PROXY_HOPS (default 1): how many proxies in front of the API append to X-Forwarded-For. Raise it for each extra proxy, such as Cloudflare’s orange-cloud proxy.
  • DeveloperSecurity headers live in vercel.json and, for Docker, frontend/nginx-security-headers.conf. The Content-Security-Policy deliberately does not allow-list scripts, because Google AdSense and Cloudflare Turnstile load from hosts that change without notice.
  • DeveloperContinuous integration runs the backend tests and the frontend format check and build on every pull request and every push to main. Dependabot proposes dependency updates, and SECURITY.md explains how to report vulnerabilities privately.
  • DeveloperBuild output (*.egg-info) is no longer committed. The backend test suite now has 74 tests.

ArabDev 1.1.0

Signing in, and changing your email or password, are now confirmed with a six-digit code sent by email. Public forms have a Cloudflare bot check, Google ads appear, pages show up properly in search results, and Settings has a new Security section.

  • Emailed codesSigning in, signing up, and changing an email or password are confirmed by a six-digit code.
  • Bot checkCloudflare Turnstile checks every public form. Almost nobody has to click anything.
  • Google adsRequested in non-personalised mode, and labelled.
  • Search resultsEach page has its own title, description and link preview, plus a sitemap and structured data.
  • SettingsYour devices, a copy of your data, the feed to open first, reduced motion and email preferences.

Signing in and signing up

  • NewSigning in and creating an account are confirmed with a six-digit code sent to your email address. The code is valid for 10 minutes and works once.
  • NewAn account is not created until its address is confirmed, so a mistyped email cannot leave an account you can never reach.
  • NewA code can be sent again after 60 seconds, up to four times, and only the newest code in your inbox works.
  • NewChanging your email address sends the code to the new address, and the old address is told about the change afterwards.
  • NewChanging your password is confirmed by a code as well, so a borrowed screen is not enough to take an account over.
  • SecurityCodes are stored only as a hash, cannot be tried more than five times, and are destroyed once used.
  • SecurityEight wrong passwords for the same address within fifteen minutes now pauses sign-in for that account, however many networks the attempts come from.

Bot protection

  • NewCloudflare Turnstile now guards sign-in, sign-up, password resets, email and password changes, publishing a post and writing a comment.
  • NewThe check is invisible for almost everyone: it only shows a widget when it genuinely has to ask something.
  • SecurityEvery token is checked on the server against Cloudflare, tied to the action it was issued for, and refused if it is replayed or older than five minutes.

Settings

  • NewA new Security section: sign-in codes, account alerts, the devices you are signed in on, and your data.
  • NewThe devices list shows every browser holding a live session, marks the one you are using, and can sign out one of them or all the others.
  • NewDownload my data exports your account, profile, settings, posts, drafts, comments, likes, bookmarks and follows as one JSON file.
  • NewChoose which feed the home page opens on: For you, Following or Latest.
  • NewA Reduce animation switch for people who would rather the interface held still.
  • NewEmail preferences: keep or switch off account alerts and release announcements. There is still no marketing email.
  • ImprovedThe account page shows whether your email address has been confirmed.

Ads

  • NewAd space is now filled by Google AdSense, requested in non-personalised mode: ads are chosen by the page and your general region, never by a profile of you.
  • NewAn ads.txt file names Google as the only company allowed to sell advertising on arabdev.site.
  • ImprovedAds keep their dashed frame and “Sponsored” label, and an unfilled ad box now collapses instead of leaving a gap.
  • ImprovedDirect sponsors are still served by ArabDev itself, with no third-party code.

Phones

  • NewArabDev can be installed to a phone home screen, with its own icon, name and start page.
  • FixedSettings could be scrolled sideways on a phone. Grid columns no longer stretch to fit their widest child.
  • ImprovedContent now clears the home indicator on phones with a rounded screen.

Security and privacy

  • NewAn email when your password changes or a new browser signs in, unless you switch those alerts off.
  • SecurityAccess tokens now name the session they belong to, which is how the devices list knows which browser is asking.
  • SecurityTwo more response headers: a permissions policy that refuses camera, microphone, location and payment, and strict transport security in production.
  • ImprovedThe privacy policy has been updated to describe Google ads, the Cloudflare check and the emailed codes, in both languages.

API and developers

  • DeveloperPOST /auth/register and POST /auth/login now answer with status, plus either tokens or a challenge; POST /auth/verify exchanges a code for tokens and POST /auth/resend sends another.
  • DeveloperNew endpoints: GET /auth/config, POST /users/me/email and /verify, POST /users/me/password and /verify, GET /users/me/sessions, DELETE /users/me/sessions/{id}, POST /users/me/sessions/revoke-others and GET /users/me/export.
  • DeveloperProtected endpoints read the Turnstile token from an X-Turnstile-Token header, so request bodies are unchanged.
  • DeveloperNew settings: SMTP details, EMAIL_CODES_ENABLED, the code lifetime and attempt limits, and the two Turnstile keys. Without SMTP in production the codes stay off, so a missing mail provider cannot lock anyone out.

ArabDev 1.0.0

The first public release of ArabDev: a community for Arabic-speaking developers to write technical posts, follow each other and discover new topics, fully in Arabic and English. Entries marked New describe what ships in this release. Improved and Fixed entries describe changes made while testing the release before launch.

  • EditorHeadings, code blocks, tables, links, three fonts, six sizes and five colours that work in dark mode, with a preview and drafts.
  • Arabic and EnglishThe interface switches between right-to-left and left-to-right, and each paragraph takes its own direction.
  • FeedThree tabs, 20 posts a page, and numbered pages instead of endless scrolling.
  • AdsLabelled, one after every 8 posts, and never chosen from your personal information.
  • SecurityArgon2id passwords, rotating sessions that notice stolen tokens, and cleaned post content and uploads.
  • PrivacyNo trackers, no third-party analytics, and a privacy policy in plain language.

Accounts and sign-in

  • NewA split landing page: the ArabDev story on one side and sign-in or registration on the other. On phones the two stack vertically.
  • NewCreate an account with a username, email address and password (entered twice). Creating an account signs you in straight away.
  • NewUsernames are 3 to 20 characters, use English letters, numbers and underscores, start with a letter, and are not case-sensitive.
  • NewReserved names such as admin, api, settings, explore and support cannot be registered.
  • NewLive username availability check while you type, with a green check mark or a clear message such as “This username is already taken”.
  • NewThe email field checks that no other account uses the address as soon as you leave it.
  • NewPassword rules: 8 to 128 characters, at least one letter and one number, and not overly repetitive.
  • NewA password strength bar rates your password as weak, fair, good or strong while you type.
  • NewShow and hide buttons on every password field.
  • NewError messages appear under the field they belong to, in your language, instead of as a generic alert.
  • NewThe interface language you use while registering becomes your saved language preference.
  • NewSign in with email and password, with a Keep me signed in option that lasts up to 30 days.
  • NewWithout Keep me signed in, the session ends when the browser closes, and after 12 hours at most.
  • NewForgot-password flow: request a reset link, open it within 30 minutes, choose a new password.
  • NewSign out from the account menu, which ends the session on that browser.
  • NewPages that need an account send guests to sign in and bring them back to where they were afterwards.
  • NewSigned-in visitors who open the sign-in or registration page are taken to their feed instead.
  • NewYour session is restored silently when you reopen ArabDev, without a flash of the sign-in page.
  • SecuritySign-in says only “Email or password is incorrect” and takes the same time whether or not the email is registered.
  • SecurityThe forgot-password form gives the same answer for every address, so it cannot reveal who has an account.
  • SecurityResetting a password ends every existing session for the account.
  • ImprovedGuests no longer make an unnecessary session request on every visit: ArabDev only tries to restore a session in browsers that have signed in before.

First-visit setup

  • NewA four-step setup window opens on your first visit after creating an account.
  • NewA progress bar and a “Step 2 of 4” counter show where you are.
  • NewStep 1: upload a profile picture, with an instant circular preview while it uploads, and replace or remove it.
  • NewStep 2: adjust your username (with the same availability check), set a display name and write a short bio with a character counter.
  • NewStep 3: choose your interests from 25 topics. Selected topics show a check mark as well as a tinted background.
  • NewStep 4: up to eight suggested developers, based on the interests you just chose, each with a follow button.
  • NewEvery step can be skipped, and the window can be closed at any time. Anything skipped can be finished later in Settings.
  • NewFinishing or closing the setup is remembered on your account, so it never appears again on any device.
  • NewThe last step ends with a “Go to my feed” button that opens a feed already shaped by your choices.
  • NewOn phones the setup opens full screen so every step fits comfortably.

Navigation and pages

  • NewA navigation column with labels on wide screens: Home, Explore, Notifications, Bookmarks, Profile, Settings and a Create post button.
  • NewA narrow icon rail with tooltips on tablets.
  • NewA bottom navigation bar on phones with Home, Explore, Create, Notifications and Profile.
  • NewA side column on wide screens with suggested developers, one ad and popular tags.
  • NewAn account menu with Edit profile, Drafts, Bookmarks, Settings, theme and language switches, documentation links and Sign out.
  • NewA Bookmarks page listing everything you saved, newest save first.
  • NewA Drafts page with pagination, excerpts and tags.
  • NewA friendly “page not found” screen with a way back home.
  • NewYour home feed is the dashboard at arabdev.site/dashboard, and arabdev.site takes you straight there (or to sign in).
  • NewA Support link in the account menu and in every footer, which opens an email to support@arabdev.site.
  • NewSettings sections have their own addresses, such as /settings/privacy.
  • NewEach page is loaded only when you first open it, keeping the first visit small.
  • NewPage titles in the browser tab describe the page, such as a post title or a person's name.
  • NewLoading placeholders shaped like the content they stand in for.

Profiles

  • NewPublic profiles at /u/username, readable without an account.
  • NewProfiles show picture, display name, @username, bio, location, website and joining month.
  • NewFollowing, followers and posts counts, with the first two opening the full lists.
  • NewA “Follows you” badge when the person follows you.
  • NewInterests are shown as chips that open the matching tag page.
  • NewProfile tabs: Posts (including reposts), Replies (comments with a link to their post) and, on your own profile, Saved.
  • NewEvery profile tab is paginated, 20 items per page.
  • NewFollowers and following pages show each person as a card with bio, interests and a follow button.
  • NewA profile editor for display name (up to 50 characters), username, bio (up to 280), location (up to 60), website (up to 200) and interests.
  • NewThe Save button stays disabled until something changes, and problems are shown under the field concerned.
  • NewWebsite addresses without https:// have it added automatically, and are displayed as a short host name.
  • NewProfile pictures: JPEG, PNG, WebP or GIF up to 5 MB, cropped to a centered square and resized to 400×400.
  • NewPeople without a picture get their initials on a colored circle instead.
  • NewReplacing or removing a profile picture deletes the old file.
  • NewA friendly page for profiles that do not exist, instead of an error.
  • NewPeople who hide their connections show “This account keeps its connections private” on their lists.
  • ImprovedThe profile tabs now stay pinned under the top bar while you scroll.
  • FixedClicking a profile picture no longer shows a stray underline beneath it.

Home feed

  • NewA home feed with three tabs: For you, Following and Latest.
  • NewFor you groups posts by day, then shows people you follow first, then posts matching your interests, then everything else, newest first within each group. Nothing is hidden, only reordered.
  • NewFollowing shows your posts, posts from people you follow, and posts they reposted.
  • NewIf several people you follow repost the same post, it appears once, with a label naming who reposted it.
  • NewLatest shows every post strictly newest first.
  • NewServer-side pagination: 20 posts per page, with Previous, Next and numbered page links. No infinite scroll.
  • NewOn phones the page links are replaced by a compact “Page 2 of 5”.
  • NewThe tab and page number are kept in the address (/dashboard?tab=following&page=2), so reloading or sharing keeps your place.
  • NewChanging page returns you to the top of the feed.
  • NewA “What are you working on?” box at the top of the feed that opens the editor.
  • NewLoading placeholders shaped like posts, instead of spinners.
  • NewHelpful empty states: “No posts yet” with a button to write one, and an empty Following tab that points you to Explore.
  • NewA retry button if the feed cannot be loaded.
  • ImprovedThe current page stays visible, slightly faded, while the next page loads, so the screen never flashes blank.

Post editor

  • NewA rich post editor with an optional title of up to 200 characters.
  • NewParagraphs, headings and subheadings.
  • NewBold, italic, underline, strikethrough and inline code.
  • NewBulleted and numbered lists, including nested lists.
  • NewQuotes, shown with a red bar at the start of the line.
  • NewCode blocks on a dark background, always left-to-right, even inside Arabic posts.
  • NewTables with a header row: insert, add or remove rows and columns, and delete the table.
  • NewLinks through a dialog to add, change or remove a link on the selected text.
  • NewText alignment: start, center, end and justify, following each paragraph's own direction.
  • NewThree fonts: Tajawal, Alexandria and Anton, each shown in its own typeface in the menu.
  • NewSix text sizes: 14, 16, 18, 20, 24 and 30.
  • NewFive text colors (Red, Dark red, Ink, Graphite and Muted) that each have a light-mode and a dark-mode shade, so colored text stays readable in both.
  • NewUndo and redo buttons.
  • NewToolbar buttons are highlighted when their formatting is active at the cursor.
  • NewThe toolbar stays pinned under the top bar while you write long posts, and scrolls sideways on narrow screens.
  • NewKeyboard shortcuts, for example Ctrl + B for bold, Ctrl + E for inline code and Ctrl + Alt + C for a code block.
  • NewMarkdown-style shortcuts while typing: ## for a heading, - for a list, ``` for a code block and **bold** for bold text.
  • NewTab in a table moves to the next cell, and adds a row from the last cell.
  • NewEach paragraph, heading, list item and table cell picks its own direction from its first letters, so Arabic and English mix naturally in one post.
  • NewAttach one image per post (JPEG, PNG, WebP or GIF, up to 5 MB) with an upload progress bar and a remove button.
  • NewLarge images are scaled to fit 1600×1600 and saved as WebP.
  • NewRemoving an image you just uploaded, before saving, deletes it from the server.
  • NewAttach one link that the post is about; it is shown under the post as a card with the site name and address.
  • NewUp to 5 tags per post, entered with Enter, picked from suggestions, or pasted separated by commas.
  • NewA live preview that shows the post exactly as readers will see it: next to the editor on wide screens, behind a Preview tab on smaller ones.
  • NewDrafts: save everything without publishing, including title, body, tags, image and link.
  • NewAfter the first save, a draft gets its own address (/drafts/12), so reloading is safe.
  • NewA Drafts page listing your drafts, most recently edited first, with excerpts, tags and a discard button.
  • NewPublishing a draft turns it into a post and removes the draft.
  • NewA “Discard your changes?” prompt when leaving the editor with unsaved work, plus the browser's own warning when closing the tab.
  • NewEdit your own posts with the same editor; edited posts show an “edited” note.
  • NewClear messages for an empty post or an invalid link, shown where the problem is.
  • ImprovedThe font size menu is wide enough to show its values in full.
  • FixedThe leave-the-editor dialog no longer repeats its question twice.
  • SecurityPasted content keeps only the fonts, sizes and colors the editor offers; everything else is removed on the server when you publish.

Editor shortcuts and Markdown

Every shortcut below was checked against the editor itself. The Formatting reference in the wiki lists them all in one table.

  • NewCtrl + B for bold, Ctrl + I for italic and Ctrl + U for underline.
  • NewCtrl + Shift + S for strikethrough.
  • NewCtrl + E for inline code.
  • NewCtrl + Alt + 2 for a heading and Ctrl + Alt + 3 for a subheading.
  • NewCtrl + Shift + 8 for a bulleted list and Ctrl + Shift + 7 for a numbered list.
  • NewCtrl + Shift + B for a quote.
  • NewCtrl + Alt + C for a code block.
  • NewCtrl + Z to undo, and Ctrl + Shift + Z or Ctrl + Y to redo.
  • NewShift + Enter for a line break inside the same paragraph.
  • NewTab and Shift + Tab indent and outdent list items.
  • NewOn Mac, ⌘ works wherever the shortcuts say Ctrl.
  • NewType ## and a space for a heading, or ### and a space for a subheading.
  • NewType -, * or + and a space for a bulleted list.
  • NewType 1. and a space for a numbered list that starts at that number.
  • NewType > and a space for a quote.
  • NewType ``` and a space for a code block, optionally with a language name such as ```python.
  • NewType --- for a horizontal divider.
  • NewWrap text in ** for bold, * or _ for italic, ~~ for strikethrough and backticks for inline code.
  • NewTyping or pasting a web address followed by a space turns it into a link.
  • NewPasting an address while text is selected turns the selected text into a link.
  • NewThe table dialog lets you choose 1 to 20 rows, 1 to 8 columns and whether the first row is a header.
  • NewInside a table, the table button offers Add row below, Add column after, Delete row, Delete column and Delete table.
  • NewWide tables scroll sideways on small screens instead of squeezing their content.
  • NewLink addresses typed without https:// have it added automatically.
  • NewChoosing the active alignment again removes it, returning the paragraph to its natural alignment.

Reading posts

  • NewPost cards show the author, relative time (with the exact date on hover), title, content, image, link card and tags.
  • NewLong posts are cut in the feed with a gentle fade and a “Read more” link.
  • NewClicking anywhere on a card opens the post, except on links, buttons and text you are selecting.
  • NewA full post page with the complete content, the author's follow button and the discussion.
  • NewAn estimated reading time at the top of every post page.
  • NewPosts without a title are labelled with their author's name instead.
  • NewA ⋯ menu on posts with Copy link for everyone, and Edit post and Delete post for the author.
  • NewDeleting a post asks for confirmation and explains that its comments, likes, reposts and saves go with it.
  • NewMentions (@username) in posts notify the people mentioned, up to 10 people per post.
  • NewLinks inside posts open in a new tab.
  • NewQuotes, lists and tables keep the direction of the language they are written in, even inside the other language's interface.
  • NewImages in posts are described for screen readers using the post title.
  • NewA clear page for posts that were deleted or never existed.
  • FixedThe follow button on a post page now shows whether you already follow the author, instead of always showing “Follow”.
  • FixedTags written in Arabic are now displayed in the correct direction.

Likes, reposts, saves and sharing

  • NewAn action row under every post: comment, repost, like, save and share, each with its count when above zero.
  • NewLikes: the heart fills in red and the count updates instantly.
  • NewReposts share a post with your followers and appear on your profile; select again to undo.
  • NewYou cannot repost your own post, so the button is disabled there.
  • NewSaves (bookmarks) are completely private and listed on the Bookmarks page and your profile's Saved tab.
  • NewShare uses your device's share sheet where available, or copies the link and says “Link copied”.
  • NewEvery change appears immediately and is undone automatically if the server refuses it.
  • NewYour like, save and repost state stays consistent everywhere the same post appears: feed, profile, search and the post page.
  • NewGuests who try to like, repost or save are asked to sign in and brought back to the post.
  • NewUndoing a like or repost before the author reads the notification withdraws the notification.
  • NewButtons announce their state to screen readers, for example “Like (4)” and whether it is pressed.

Comments

  • NewA Discussion section under each post, oldest comment first, 20 per page.
  • NewPlain-text comments of 1 to 2000 characters, with line breaks kept and a character counter.
  • NewSend with the Comment button or Ctrl + Enter.
  • NewReplies: choose Reply to show a “Replying to @username” chip, and remove the chip to cancel.
  • NewAfter posting, the discussion jumps to the page that contains your new comment.
  • NewMentions in comments become links to profiles and notify the people mentioned.
  • NewOne notification per person per comment, even if a comment both replies to and mentions them.
  • NewComments can be deleted by their author, the post's author or an administrator; replies go with them.
  • NewArabic and English comments each align correctly on their own.
  • FixedEvery mention in a comment is now linked; previously every second mention in a comment could be missed.
  • FixedEnglish usernames mentioned inside Arabic sentences no longer jump to the wrong place in the line.

Community and moderation

  • NewCommunity guidelines in the wiki: share generously, credit others, welcome beginners, and write in whichever language serves your readers.
  • NewClear rules against harassment, hate, spam, sharing private information, malware and impersonation.
  • NewGuidance for responsible security research and disclosure.
  • NewPost authors can remove comments on their own posts.
  • NewAdministrators can remove any post or comment that breaks the guidelines, and deactivate accounts for serious or repeated abuse.
  • NewDeactivated accounts cannot sign in and are left out of suggestions and search.

Following and suggestions

  • NewFollow and unfollow from profiles, suggestion cards, people lists and post pages.
  • NewThe Following button turns into a red “Unfollow” on hover or keyboard focus, so the action is clear before you take it.
  • New“Developers to follow” suggestions scored by shared interests (3 points each) and people you follow who follow them (2 points each).
  • NewSuggestions never include you, people you already follow, deactivated accounts, or people who turned off discoverability.
  • NewVisitors who are not signed in see the most-followed developers.
  • NewFollowing someone updates their follower count and your following count everywhere at once.
  • NewUnfollowing before the person reads the notification withdraws it.

Explore, trending and tags

  • NewAn Explore page open to everyone, with search, trending posts, popular tags and developers to follow.
  • NewTrending this week ranks the last 7 days' posts by likes plus twice their comments plus twice their reposts, favouring conversation.
  • NewIf nothing was posted in the last week, Trending falls back to the all-time ranking instead of showing nothing.
  • NewPopular tags ranked by use over the last 30 days, with the top three highlighted.
  • NewTag pages at /tags/name with the tag's posts, newest first, and how many posts use it.
  • NewTags are tidied automatically: lower-case, spaces become hyphens, a leading # is removed, and Arabic tags are supported.
  • NewCommon spellings are merged into one tag, for example js → javascript, c++ → cpp and node.js → nodejs.
  • New25 interests, from JavaScript and Rust to Cybersecurity and UI/UX, each linked to a tag so posts and people meet.
  • NewInterest names are translated into Arabic where developers use an Arabic name, and kept as-is for languages and frameworks.
  • NewOn smaller screens, popular tags and suggestions move to the top of Explore.
  • ImprovedTag pages show the number of posts with correct Arabic and English plural forms.

Notifications

  • NewNotifications for likes, comments and replies, new followers, reposts and mentions.
  • NewA red unread badge on the Notifications item, refreshed every 30 seconds.
  • NewUnread notifications have a tinted background, a bold name and a “New” label, so they stand out without relying on color.
  • NewEach notification shows who acted, what they did, the post title and, for comments, the comment itself.
  • NewSelecting a notification marks it as read and opens the post or profile.
  • NewMark all as read.
  • NewNo notifications for your own actions, and no duplicates for repeated likes, follows or reposts.
  • NewEach kind of notification can be switched off in Settings.
  • NewChoose who can notify you with a mention: everyone, people you follow, or no one.
  • NewThe notifications list is paginated, 20 per page, and refreshes every minute while open.

Settings

  • NewSettings grouped into Account, Profile, Appearance, Privacy and Notifications, as a side list on wide screens and tabs on phones.
  • NewChange your email address, confirmed with your current password.
  • NewChange your password; other devices are signed out and the current one stays signed in.
  • NewTheme: Light, Dark or System, which follows your device.
  • NewLanguage: العربية or English.
  • NewTheme and language are saved to your account and follow you to other devices.
  • NewPrivacy: “Show me in search and suggestions” and “Show my followers and following lists”.
  • NewFive notification switches: likes, comments and replies, new followers, reposts and mentions.
  • NewSwitches save immediately with a “Settings saved” message, and go back if saving fails.
  • NewDelete my account, confirmed with your password, which permanently removes the account and everything linked to it.
  • NewQuick theme and language switches in the account menu.
  • NewA link to the privacy policy from the Privacy section.

Clear messages

  • New“Too many attempts. Wait a moment and try again.” when a rate limit is reached.
  • New“Your session has expired. Please sign in again.” when a session has ended.
  • New“This username is reserved.” for names the site uses itself.
  • New“Passwords don't match.” when the two password fields differ.
  • New“Mix letters and numbers so it's harder to guess.” for weak passwords.
  • New“Images must be 5 MB or smaller.” and “Use a JPEG, PNG, WebP or GIF image.” for rejected uploads.
  • New“This file isn't a valid image.” for damaged or disguised files.
  • New“This image is too small.” and “This image's dimensions are too large.”, with the exact limits in the wiki.
  • New“Write something before publishing.” when a post has no body.
  • New“Enter a valid link starting with http:// or https://.” for invalid attached links.
  • New“You can't repost your own post.” when trying to repost yourself.
  • New“Can't reach the server.” when the connection drops, with a retry button where it helps.
  • NewEvery message exists in Arabic and English, and the wiki's Troubleshooting article explains each one.

Ads

  • NewAds in feeds after every 8 posts, so at most two on a 20-post page, never at random positions.
  • NewOne ad slot in the side column on wide screens.
  • NewEvery ad has a boxed “Sponsored” label, says who promotes it, and uses a dashed frame and tinted background so it cannot be mistaken for a post.
  • NewAn information icon explains why ads are shown.
  • NewAds are chosen only by placement, language and page number, and rotate predictably between pages.
  • NewAds can target Arabic, English or both, and can have start and end dates.
  • NewImpressions and clicks are counted as totals, never linked to people.
  • NewArabDev launches with its own house ads, labelled “Promoted by ArabDev”.
  • NewNo ads inside posts, comments, profiles, search results, notifications or settings, and no pop-ups.
  • FixedThe “Sponsored” label now uses normal capitalisation instead of shouting in capitals.
  • FixedLists that never show ads, such as profile tabs, no longer request them.

Arabic, English and right-to-left

  • NewA complete Arabic interface, which is the default, and a complete English interface.
  • NewSwitching language flips the entire layout at once: navigation, menus, drawers, spacing and alignment.
  • NewDirection-sensitive icons, such as back arrows, pagination arrows and undo, are mirrored in Arabic.
  • NewProper Arabic plural forms for counts: one, two, a few and many each have their own wording.
  • NewDates and relative times in the interface language, for example “3 hr. ago” and «منذ 3 ساعات».
  • NewWestern digits (0–9) in both languages, which read best next to code.
  • NewUsernames, email addresses and code are always shown left-to-right, even in Arabic sentences.
  • NewError messages from the server arrive in your language.
  • NewThe page's language and direction are set before it first appears, so there is no flicker on load.
  • NewAll interface text lives in two translation files, so nothing is hard-coded in one language.
  • FixedThe language switch is now available on phones before signing in.

Design and dark mode

  • NewThe ArabDev identity: “Arab” in red and “Dev” in black (white in dark mode), set in Anton.
  • NewAlexandria for headings, Tajawal for body text and Anton for the logo and statistics, all hosted by ArabDev itself.
  • NewA red and white visual identity with a carefully tuned dark mode.
  • NewDark mode that follows your device by default, with a manual choice in Settings and the account menu.
  • NewNo flash of the wrong theme while pages load.
  • NewA three-column layout on wide screens, an icon rail on tablets and a bottom navigation bar on phones.
  • NewA red Create button in the middle of the phone navigation bar.
  • NewAn ArabDev favicon.
  • FixedThe phone header no longer wraps onto two lines.

Accessibility

  • NewA “Skip to content” link on the first press of Tab.
  • NewEvery control can be reached and used with the keyboard, with a clear red focus outline.
  • NewIcon-only buttons have spoken names, and toggles announce whether they are on.
  • NewSearch suggestions follow the standard combobox pattern for screen readers.
  • NewDialogs keep focus inside them until they are closed.
  • NewLoading areas are marked as busy, and messages such as “Link copied” are announced.
  • NewState is never shown by color alone: unread notifications have a “New” label and selected interests a check mark.
  • NewContrast that meets common guidelines in both light and dark mode.
  • NewAnimations are turned off when your device asks for reduced motion.
  • NewPages zoom without losing content, from small phones to wide screens.
  • NewEvery page has a meaningful title, such as the post title or the person's name.

Performance

  • NewThe server sends at most 20 posts at a time, and each page is fetched with a fixed number of database queries, however many posts it contains.
  • NewThe editor is loaded only when you open it, so reading ArabDev stays fast.
  • NewThe interface library and the editor are split into separate, cacheable bundles.
  • NewRecently viewed data is reused instantly and refreshed quietly in the background.
  • NewPopular tags and the interests list are cached on the server.
  • NewUploaded images are served with long-lived cache headers because their names never change.
  • NewLarge API responses are compressed.
  • NewFonts are self-hosted as WOFF2 and shown with font-display: swap, so text is readable immediately.
  • NewSearch suggestions wait for you to pause typing, instead of querying on every keystroke.
  • NewSQLite runs in write-ahead-log mode so reading and writing do not block each other.

Security

  • SecurityPasswords are hashed with Argon2id and upgraded automatically if hashing settings get stronger.
  • SecurityShort-lived access tokens (15 minutes) kept only in the page's memory, never in browser storage.
  • SecurityLong-lived sign-in tokens are random, stored only as SHA-256 hashes, and delivered in an HttpOnly cookie limited to the sign-in endpoints.
  • SecuritySign-in tokens rotate on every use; reuse of an old token ends the whole session family.
  • SecurityChanging or resetting your password immediately invalidates every outstanding access token.
  • SecuritySession renewal and sign-out require a custom header that other websites cannot send, blocking cross-site request forgery.
  • SecurityPassword reset links are single-use, expire after 30 minutes and are stored only as hashes.
  • SecurityRate limits on sign-in, registration, password reset, publishing, commenting, interactions, follows, uploads and search.
  • SecurityRate limits are shared between server processes through Redis when it is configured.
  • SecurityPosts are sanitised on the server with a strict allow-list of tags, attributes, fonts, sizes, colors and link schemes.
  • SecurityPosts are sanitised again in the browser before being displayed, as a second line of defence.
  • SecurityLinks in posts only allow http, https and mailto, and are marked noopener noreferrer nofollow ugc.
  • SecurityUploads are decoded as real images and re-encoded; anything else is refused.
  • SecurityUpload size is limited to 5 MB, and extreme image dimensions are rejected.
  • SecuritySecurity headers stop other sites from framing ArabDev and stop browsers from guessing file types.
  • SecurityEvery permission is checked on the server: only authors can edit their posts, and only the right people can delete comments.
  • SecurityChanging your email address or deleting your account requires your current password.
  • SecurityImages can only be attached by the account that uploaded them.
  • SecurityThe API refuses to start in production without a real secret key.
  • SecurityBrowser access to the API is limited to configured origins.
  • SecurityEnded sign-in sessions and old password reset links are deleted automatically: when the API starts, then every six hours on a server or once a day on Vercel.
  • FixedTwo tabs renewing the session at the same moment no longer sign you out: a 20-second grace period tells this apart from real token theft.

Limits that keep ArabDev fair

Normal use never comes close to these limits. They exist to stop automated abuse.

  • SecuritySign in: 10 attempts per minute per network.
  • SecurityCreate account: 10 per hour per network.
  • SecurityForgot password: 5 requests per 15 minutes.
  • SecurityReset password and change password: 10 each per 15 minutes.
  • SecurityUsername and email availability checks: 60 per minute.
  • SecuritySession renewal: 60 per minute.
  • SecurityPublishing posts: 30 per hour.
  • SecurityComments: 60 per 10 minutes.
  • SecurityLikes, saves and reposts: 300 per hour.
  • SecurityFollows: 120 per hour.
  • SecurityImage uploads: 30 per 10 minutes.
  • SecuritySearch: 120 per minute.
  • SecurityAd click counting: 60 per minute, so totals cannot be inflated.
  • NewPosts: up to 5 tags of 30 characters each, a 200-character title, and one attached link of up to 500 characters.
  • NewA single post notifies at most 10 mentioned people.

Privacy

  • NewA full Privacy Policy in Arabic and English, organised by topic, with a promise that ArabDev never sells user information.
  • NewNo third-party analytics, trackers, advertising pixels or social widgets.
  • NewOnly one cookie, which keeps you signed in. No cookie banner is needed because nothing tracks you.
  • NewLocation and camera metadata are removed from every uploaded image.
  • NewAds never use personal information, and advertisers receive nothing about users.
  • NewBookmarks and drafts are private, and authors are never told who saved their posts.
  • NewTurn off discoverability to leave suggestions and people search.
  • NewHide your followers and following lists.
  • NewAccount deletion removes your content, interactions, uploads and sessions immediately, and recalculates counts on other posts.
  • NewEmail addresses are never shown to other users.
  • NewSearch terms are not stored.

API and developers

  • DeveloperA versioned REST API under /api/v1 covering everything the app does.
  • DeveloperInteractive documentation at /api/docs and /api/redoc, and an OpenAPI description at /api/v1/openapi.json.
  • DeveloperEvery list endpoint uses the same pagination: page and limit in, {items, page, limit, total, pages} out.
  • DeveloperConsistent errors: a readable detail, a stable code, and field or errors for validation problems.
  • DeveloperError messages are translated using the Accept-Language header.
  • DeveloperRate-limited responses return HTTP 429 with a Retry-After header.
  • DeveloperAuthentication endpoints: register, login, refresh, logout, availability, forgot-password and reset-password.
  • DeveloperAccount endpoints for profile, username, email, password, interests, settings, onboarding, avatar, bookmarks and deletion.
  • DeveloperFeed endpoint with tab=for_you|following|latest and an optional tag filter, plus a trending endpoint.
  • DeveloperPost, draft, comment, like, bookmark, repost and follow endpoints.
  • DeveloperSearch with type=all|posts|users|tags, popular tags, tag details and the interests list.
  • DeveloperNotification endpoints with an unread count, mark-one and mark-all.
  • DeveloperMedia upload and deletion of unused uploads.
  • DeveloperAd serving and click counting, plus administrator endpoints to create, update and delete ads.
  • DeveloperA health endpoint that reports database and Redis status.
  • DeveloperA layered backend: routes, services and repositories, with Pydantic schemas for every request and response.
  • DeveloperA typed SQLAlchemy 2 data model with 19 tables and Alembic migrations.
  • DeveloperA storage abstraction for uploads, with a local-disk backend ready to be swapped for object storage.
  • DeveloperAn email abstraction; without a provider, emails are written to the server log.
  • DeveloperA typed frontend API client with automatic, single-flight session renewal.
  • DeveloperQuery keys and cache updates organised so one change updates every list that shows the same post or person.

Data model

  • Developerusers, profiles and user_settings: accounts, public profile details and preferences, one row each per person.
  • Developerinterests and user_interests: the 25 topics and who chose them.
  • Developerposts, tags and post_tags: published posts and their tags, with tag names normalised.
  • Developerdrafts: unpublished posts, private to their author.
  • Developercomments: comments and replies, each linked to its post and, for replies, to the comment it answers.
  • Developerlikes, bookmarks, reposts and follows: one row per interaction, with composite keys that make duplicates impossible.
  • Developernotifications: who did what to whom, and whether it has been read.
  • Developermedia: uploaded images with owner, kind, size and dimensions.
  • Developerads: ad content, placement, language, schedule and aggregate counters.
  • Developerrefresh_tokens and password_reset_tokens: hashed tokens only, never the raw values.
  • DeveloperPost counters (likes, comments, reposts) are stored on the post and recalculated when accounts or comments are deleted, so lists never need expensive counting.
  • DeveloperDeleting an account or a post removes every dependent row through database-level cascades.
  • DeveloperAll timestamps are stored in UTC and returned with a time zone.

Backend architecture

  • DeveloperRoutes stay thin: they validate input, check permissions and call a service.
  • DeveloperServices hold the business rules: authentication, users, posts, interactions, comments, notifications, discovery, ads and media.
  • DeveloperRepositories hold the database queries, including the For you ranking, the following feed and trending.
  • DeveloperPresenters build API responses for a whole page at once, loading authors, tags and your interaction state in a few batched queries.
  • DeveloperValidation errors carry stable codes that the frontend translates, instead of English sentences.
  • DeveloperSettings are typed and loaded from the environment, with safe development defaults.
  • DeveloperA cache layer that uses Redis when available and memory otherwise.
  • DeveloperImages are processed with Pillow: decoded, checked, resized, stripped of metadata and saved as WebP.
  • DeveloperThe HTML sanitiser allows only the markup the editor produces, including its fonts, sizes, theme colors, alignment and text direction.
  • DeveloperSeed data: 25 interests and 6 house ads, inserted idempotently.
  • DeveloperDemo data: ten fictional developers with posts, follows, likes and comments, for trying ArabDev locally.
  • DeveloperEnded sessions and old reset links are deleted by a background task every six hours on a server, and by a scheduled job on Vercel; both reuse the same clean-up.

Frontend architecture

  • DeveloperOrganised by feature: auth, onboarding, posts, editor, comments, discovery, search, notifications, profile, users, ads and preferences.
  • DeveloperEvery page is a lazily loaded route, with guards for signed-in only and signed-out only pages.
  • DeveloperServer data is cached for 30 seconds and kept for 5 minutes; client errors are not retried, and server errors are retried twice.
  • DeveloperOptimistic updates for likes, saves, reposts, follows and settings, rolled back on failure.
  • DeveloperA single API client adds the access token and language to every request and renews the session once when several requests fail together.
  • DeveloperTheme built on CSS variables for light and dark schemes, so switching theme does not re-render the app.
  • DeveloperA right-to-left style cache that mirrors layout styles automatically for Arabic.
  • DeveloperPost content uses logical CSS properties, so content keeps its own direction regardless of the interface language.
  • DeveloperAll text comes from ar.json and en.json, with Arabic plural rules.
  • DeveloperA small, shared set of building blocks: empty states, error states, skeletons, pagination, confirmation dialogs and notifications.
  • DeveloperPage titles and language attributes are managed centrally.

Running and deployment

  • DeveloperSQLite as the database, with write-ahead logging, foreign keys and a busy timeout enabled.
  • DeveloperConfiguration through environment variables and .env files, with documented examples.
  • DeveloperRedis is optional: without it, rate limiting and caching fall back to memory.
  • Developerpython -m app.cli seed adds the 25 interests and house ads, and is safe to run repeatedly.
  • Developerpython -m app.cli seed --demo adds ten fictional developers and their posts for local testing.
  • Developerpython -m app.cli make-admin USERNAME grants administrator rights.
  • Developerpython -m app.cli purge-tokens deletes ended sessions and old reset links on demand.
  • DeveloperDocker Compose setup with Redis, the API and an nginx container serving the app on port 8080.
  • DeveloperThe API container applies migrations and seeds reference data when it starts.
  • DeveloperPersistent volumes for the database file and uploaded media.
  • DeveloperThe frontend builds to a static site, ready for Vercel or any static host.
  • DeveloperThe development server proxies /api and /media to the API.
  • DeveloperThe wiki, privacy policy and patch notes are self-contained static sites, with their own fonts and icon, deployed without a build step to wiki.arabdev.site, privacy.arabdev.site and patch.arabdev.site.
  • DeveloperThe development server serves those sites locally at /wiki/, /privacy/ and /patch-notes/, and links between them stay local on your machine.
  • DeveloperThe app build publishes the license at arabdev.site/LICENSE.txt.
  • DeveloperVITE_API_ORIGIN lets the app reach an API hosted on another address; the documentation addresses can be overridden the same way.
  • DeveloperRuns on Vercel: vercel.json builds the app and serves the API from api/index.py in one project, so both share an address.
  • DeveloperPostgreSQL support for hosted deployments (Neon on Vercel), with SQLite still the default for development and single-server hosting. The tests run against both.
  • DeveloperHosted Postgres URLs (postgres://, postgresql://) are pointed at the psycopg 3 driver automatically, and Neon's connection pooler is handled.
  • DeveloperOn Vercel the API migrates and seeds the database itself when an instance starts; a PostgreSQL lock keeps instances that start together from colliding.
  • DeveloperUploaded images can be kept in the database (STORAGE_BACKEND=database) for hosts without a disk, and are served with long-lived cache headers.
  • DeveloperA scheduled endpoint for the daily clean-up, protected by CRON_SECRET and hidden when it is not configured.
  • ImprovedMySQL support was removed. ArabDev uses SQLite for development and single-server hosting, and PostgreSQL when hosted on Vercel.
  • ImprovedImages between 4 and 5 MB are re-encoded in the browser before uploading, so they fit hosting limits. The server re-encodes every image anyway, so nothing visible changes.

Documentation

  • NewThe ArabDev Wiki: 25 articles in Arabic and English covering every feature, safety, troubleshooting and development.
  • NewWiki search that runs in your browser, with Arabic-aware matching and a / shortcut.
  • NewGenerated contents boxes, section links and previous/next navigation in every wiki article.
  • NewA 28-section Privacy Policy with plain-language summaries, a contents list that follows your reading, and print support.
  • NewThese patch notes, with type filters, live counts and search.
  • NewWiki articles for newcomers: Getting started, a Frequently asked questions page and a Glossary of ArabDev and developer terms.
  • NewWiki guides for every feature: profiles, the home feed, writing posts, a formatting reference, tags and interests, comments, following, search, notifications and settings.
  • NewWiki articles on trust and safety: privacy and safety, account security, ads and community guidelines.
  • NewA Troubleshooting article that explains every common message and what to do about it.
  • NewDeveloper articles: an architecture overview, running and self-hosting, a full API reference, and contributing and license.
  • NewWiki pages show one article at a time with a sidebar of every article, and keep working as one long page without JavaScript.
  • NewThe privacy policy has an “In short” summary for every section, tables of cookies, storage keys and retention periods, and a list of the data protection laws of nine Arab countries.
  • NewThe privacy policy highlights the section you are reading and shows your reading progress.
  • NewAll documentation sites work on phones, print cleanly, support dark mode and have skip links for keyboard users.
  • NewThe app opens each documentation site in your language, and switching language on them keeps your place.
  • NewA Contact and support article in the wiki: support@arabdev.site for help, bugs, reports, privacy and security, and hi@arabdev.site for sponsorship, contributions, partnerships and questions.
  • NewLinks to the wiki, privacy policy, patch notes and license in the app's side column, account menu and sign-in pages, opening in a new tab.
  • NewArabDev is free software under the GNU General Public License v3, with the full license published at /LICENSE.txt.
  • NewA README covering features, architecture, setup, configuration, deployment and backups.

Tests and code quality

  • Developer51 automated backend tests covering authentication, sessions, posts, feeds, comments, interactions, notifications, uploads, search, account deletion and serverless hosting. They run against SQLite and PostgreSQL.
  • DeveloperEvery test runs against a fresh in-memory database.
  • DeveloperStrict TypeScript across the frontend, checked with npm run typecheck.
  • DeveloperConsistent formatting with Prettier (npm run format).
  • DeveloperBuilt on current major versions: React 19, Material UI 9, React Router 8, TanStack Query 5, TipTap 3, Vite 8 and TypeScript 7.
  • DeveloperOn the server: FastAPI, Pydantic 2, SQLAlchemy 2 and Alembic.
  • FixedSeveral icons that were renamed in Material UI 9 now load correctly.
  • FixedStyling that relied on features removed in Material UI 9 was rewritten, which also removed a console warning.

Changed during pre-release testing

Before launch, ArabDev was tested page by page, in both languages, on wide and narrow screens. These are the changes that testing produced; most also appear under their area above.

  • FixedProfile tabs stopped sticking to the top of the screen after the page was scrolled.
  • FixedThe follow button on a post page always said “Follow”, even when you already followed the author.
  • FixedIn a comment with several mentions, some mentions were not turned into links.
  • FixedArabic tags were shown in the wrong direction.
  • FixedThe ad label was displayed in capital letters.
  • FixedThe phone header wrapped onto two lines on narrow screens.
  • FixedThere was no language switch on phones before signing in.
  • FixedProfile pictures used as links showed an underline.
  • FixedEnglish usernames inside Arabic comments could appear at the wrong end of the sentence.
  • FixedThe unsaved-changes dialog repeated its text.
  • FixedThe font size menu in the editor was cut off.
  • FixedVisitors who had never signed in triggered a failed session request on every page load.
  • FixedA styling rule caused a warning in the browser console.
  • FixedProfile tabs and other lists requested ads they never displayed.
  • FixedOpening ArabDev in two tabs could sign you out when both renewed the session at once.
  • FixedSome icons were missing after upgrading the interface library.
  • ImprovedThe number of posts on a tag page now uses proper plural wording in both languages.
  • ImprovedFollowing-feed and repost queries were reworked to be stricter and faster.
  • ImprovedFollowing yourself is prevented by the server with a clear error, instead of relying on the database.
  • ImprovedThe database layer was simplified to SQLite, then taught PostgreSQL as well so ArabDev could be hosted on Vercel with a Neon database.
  • SecurityExpired and ended sessions and old password reset links are now cleaned up automatically, as described in the privacy policy.
  • NewThe GNU GPL v3 license, the wiki, the privacy policy and these patch notes were added before launch.

1.0.0 by the numbers

  • 2 complete interface languages, Arabic and English, with right-to-left and left-to-right layouts.
  • 3 feed tabs and 20 posts per page.
  • 5 kinds of notifications, each with its own switch.
  • 25 interests linked to tags.
  • 3 fonts, 6 sizes and 5 theme-aware colors in the editor.
  • 19 database tables and 49 API paths.
  • 51 automated backend tests.
  • 25 wiki articles, a 28-section privacy policy, and these patch notes, each in both languages.
  • 1 cookie, and 0 trackers.

The 25 interests at launch

Chosen during setup or in Settings, and matched to the tag shown after each name.

  • JavaScript javascript
  • TypeScript typescript
  • Python python
  • C++ cpp
  • Rust rust
  • Go go
  • Java java
  • C# csharp
  • React react
  • Vue vue
  • Angular angular
  • Node.js nodejs
  • FastAPI fastapi
  • Django django
  • AI ai
  • Machine Learning machine-learning
  • Cybersecurity cybersecurity
  • Linux linux
  • DevOps devops
  • Cloud cloud
  • Databases databases
  • Game Development game-development
  • Mobile Development mobile-development
  • UI/UX ui-ux
  • Open Source open-source

Try 1.0.0 locally

The quickest way to run the whole stack is Docker Compose from the project folder:

cp .env.example .env        # set SECRET_KEY
docker compose up --build   # then open http://localhost:8080

To work on the code, run the API and the frontend separately:

cd backend
python -m venv .venv
.venv/Scripts/activate      # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
alembic upgrade head
python -m app.cli seed --demo
uvicorn app.main:app --reload --port 8000

cd ../frontend
npm install
npm run dev                 # http://localhost:5173

The Running and self-hosting article in the wiki covers configuration, deployment and backups in detail.

Where to get help

  • Start with the Getting started and FAQ articles in the wiki.
  • If something shows an error, the Troubleshooting article explains each message.
  • Account problems, bugs, content reports and privacy requests: write to support@arabdev.site. The Contact and support article explains what to include.
  • Found a security problem? Report it privately to support@arabdev.site with the subject “Security”, not in a public post.
  • Sponsorship, contributions, partnerships and other questions: write to hi@arabdev.site.
  • Developers can explore the live API documentation at /api/docs.

Known limitations

Things ArabDev 1.0.0 does not do yet. None of them are promises of a date, but they are the first areas we are looking at.

  • There are no private messages between members.
  • No email provider is connected, so password reset links are written to the server log instead of being emailed. Self-hosters can connect one in email_service.py.
  • There is no report button for posts, comments or profiles yet; send reports to support@arabdev.site.
  • Ads can only be managed through the API; there is no administration screen.
  • Posts can have one image each.
  • Comments are plain text; they do not support formatting or images.
  • There is no self-service data download yet; copies of your data are available on request.
  • Notifications appear inside ArabDev only; there are no email or push notifications.
  • With SQLite the API runs as a single process; hosting on Vercel uses PostgreSQL instead.

Requirements and upgrade notes

  • Browsers: current versions of Chrome, Edge, Firefox and Safari, on desktop and mobile.
  • To run the API: Python 3.11 or newer. To build the frontend: Node.js 20.19 or newer (or 22.12 and later).
  • This is the first release, so there is nothing to upgrade from. New installations run alembic upgrade head to create the database.
  • Set SECRET_KEY, and in production also ENVIRONMENT=production and COOKIE_SECURE=true behind HTTPS.
  • Back up arabdev.db and the media folder regularly.

Credits

ArabDev stands on the shoulders of excellent open-source work. Thank you to everyone behind:

  • Alexandria typeface · SIL Open Font License
  • Tajawal typeface · SIL Open Font License
  • Anton typeface · SIL Open Font License
  • React user interface
  • Material UI and Emotion components and styling
  • stylis-plugin-rtl right-to-left styles
  • React Router routing
  • TanStack Query data fetching and caching
  • TipTap and ProseMirror the post editor
  • i18next translations
  • DOMPurify browser-side sanitising
  • Axios HTTP client
  • Vite and TypeScript build tooling
  • FastAPI and Starlette the API
  • Pydantic validation
  • SQLAlchemy and Alembic database and migrations
  • SQLite the database
  • argon2-cffi password hashing
  • PyJWT access tokens
  • nh3 server-side sanitising
  • Pillow image processing
  • Redis optional shared limits and caching
  • pytest testing