What is new in 1.4

Open 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.

Explore 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.

Publish 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.

Use 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.

GitHub 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.

The 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 is a social site where developers post technical writing, follow each other and talk about code in the comments. It was made for Arabic speakers first: the interface runs right to left in Arabic and left to right in English, and one post can mix both, because each paragraph takes its own direction.

Pick an article from the list, or search with the box at the top (press /). The wiki opens in its own tab, so you can keep it next to ArabDev.

If you're new

Many ArabDev posts explain an idea in Arabic and show the code in English. The editor handles this without any extra steps. Each paragraph, heading, list item and table cell is marked with an automatic direction, so an Arabic paragraph lines up on the right and an English one on the left inside the same post.

Code blocks are always shown left-to-right, whatever language surrounds them. Hashtags and @mentions are isolated from the surrounding text, so @layla_dev stays readable even in the middle of an Arabic sentence.

More in Writing posts and Accessibility and languages.

Things people often miss

  • The home feed shows 20 posts a page, with numbered pages instead of endless scrolling. (The home feed)
  • Typing ## and a space at the start of a line in the editor turns it into a heading. (Formatting reference)
  • #js, #JavaScript and #javascript all end up in the same tag. (Tags and interests)
  • Every profile and every tag has an RSS feed, so you can follow it in a feed reader without an account. (Tags and interests)
  • Uploaded images are re-encoded, which removes hidden photo data such as the GPS location. (Privacy and safety)
  • You can hide yourself from search and suggestions and still be reachable through a direct link. (Settings)

All articles

About this wiki

This wiki describes ArabDev 1.3.2. When a release changes how something works, the article is updated and the change is listed in the patch notes.

The wiki is a set of plain HTML pages, with no accounts, comments, analytics or tracking. It remembers two things in your browser: light or dark mode, and your language.

This article walks you through your first ten minutes on ArabDev: creating an account, signing in, the four-step setup that runs on your first visit, and what to do next.

Creating an account

Open arabdev.site and choose Create account. You need four things:

  1. Username, the unique handle people use to mention you (for example @layla_dev).
  2. Email address, used to sign in, to receive confirmation codes and to reset your password. It is never shown on your profile.
  3. Password, entered twice to make sure there is no typo.
  4. The interface language you are using when you sign up is saved as your starting preference. You can change it at any time.

After you choose Create account, ArabDev emails a six-digit code to the address you entered. Type it in within 10 minutes to finish: your account is created only then, and you are signed in straight away. If the email does not arrive, check your spam folder, make sure the address is right, or ask for another code after 60 seconds. See Confirmation codes.

As you type a username, ArabDev checks whether it is free and shows a green check mark or a message such as "This username is already taken". When you leave the email field it also checks that no account already uses that address.

Username rules

  • 3 to 20 characters long.
  • English letters (a–z), numbers (0–9) and the underscore (_) only.
  • Must start with a letter.
  • Not case-sensitive: Layla_Dev is saved as layla_dev.
  • A few names are reserved because they are used by the site itself, for example admin, api, settings, explore, search, notifications, privacy, support and arabdev.

Your display name is separate and can be written in any script, including Arabic. See Profiles.

Password rules

  • At least 8 characters and at most 128.
  • Must contain at least one letter and at least one number.
  • Must not be too repetitive (a password made of three or fewer distinct characters is refused).

A strength bar under the password field rates your choice as weak, fair, good or strong while you type. It gives the best rating to longer passwords that mix upper- and lower-case letters, numbers and symbols. The server applies the rules above no matter what the bar shows.

Tip

A long passphrase of four or five unrelated words plus a number is both strong and easy to remember. A password manager is even better.

Signing in

Sign in with your email address and password, then enter the six-digit code ArabDev emails you. Confirming a new account signs you in automatically, so you only need this page when you come back.

  • Keep me signed in (checked by default) keeps you signed in on this browser for up to 30 days.
  • If you uncheck it, your session ends when you close the browser, and in any case after 12 hours.
  • If you type the wrong email or password, ArabDev says only "Email or password is incorrect". It never reveals whether an email address has an account.
  • After 10 attempts in one minute from the same network, or 8 attempts for the same account in 15 minutes, sign-in pauses briefly. Wait a moment and try again.
  • You can switch the sign-in code off under Settings → Security, though keeping it on is much safer.

Forgot your password? See Resetting a forgotten password.

First visit: setting up your profile

The first time you arrive after creating an account, ArabDev opens a short setup window. It has four steps, a progress bar and a counter such as "Step 2 of 4". Every step has a Skip button, and the × button in the corner closes the window for good. You can finish anything you skipped later from Settings.

Step 1: profile picture

Choose Upload photo and pick an image. A circular preview appears straight away while the image uploads. You can replace it or remove it before moving on. Accepted formats are JPEG, PNG, WebP and GIF, up to 5 MB and at least 96×96 pixels.

Step 2: username, display name and bio

Adjust your username if you like (the same availability check runs), set a display name of up to 50 characters, and optionally write a short bio of up to 280 characters. A counter under the bio shows how many characters you have used.

Step 3: interests

Pick the topics you work with, such as Python, React, DevOps or UI/UX. You can choose as many as you like; picking at least three gives better suggestions. Selected topics show a check mark and a tinted background.

Step 4: developers to follow

ArabDev suggests up to eight developers based on the interests you just chose. Each card shows their picture, name, username, bio and interests with a Follow button. Follow as many as you like, then choose Go to my feed.

What to do next

  1. Read your home feed and switch between the For you, Following and Latest tabs.
  2. Write your first post: choose Create post in the navigation. See Writing posts.
  3. Visit Explore to find trending posts, popular tags and more people to follow.
  4. Review your privacy settings and notification preferences.
  5. Pick light or dark mode and your preferred language under Settings → Appearance.

Finding your way around

Screen sizeNavigation
Large screens (1200 px and wider)A navigation column with labels (Home, Explore, Notifications, Bookmarks, Profile, Settings and a Create post button), the main column, and a side column with suggested developers, one ad and popular tags.
Tablets (900–1199 px)A narrow column of icons with tooltips, plus the main column. The side column is hidden.
Phones (under 900 px)A bar along the bottom with Home, Explore, a red Create button, Notifications and Profile. Search is the magnifying glass at the top.

Your picture in the top corner opens the account menu, with links to Edit profile, Drafts, Bookmarks and Settings, quick theme and language switches, links to this wiki, the privacy policy and the patch notes, and Sign out.

Every member has a public profile at /u/username, for example /u/layla_dev. A profile shows who someone is, what they work on and what they have written.

What a profile shows

  • Profile picture, or the initials of the display name if there is no picture.
  • Display name and @username.
  • A Follows you badge when that person follows you.
  • Bio, location and website, if filled in.
  • Joined month and year.
  • Counts of Following, Followers and Posts. The first two open the full lists, unless the person keeps them private.
  • Interests as chips. Each chip opens the matching tag page.
  • A Follow button on other people's profiles, or Edit profile on your own.

Profile tabs

TabContentsWho can see it
PostsPosts the person wrote and posts they reposted, newest activity first. Reposts carry a "reposted" label.Everyone
RepliesComments the person wrote, each with a link to the post it was written on.Everyone
SavedPosts you bookmarked.Only you, on your own profile

All three tabs are split into pages of 20 with numbered page links at the bottom.

The ⋯ menu

The ⋯ button on someone else's profile has three items: Copy link copies the profile's address, RSS feed opens the feed of their posts (see RSS feeds), and Block blocks the account (see Blocking).

Editing your profile

Open Edit profile from your profile or the account menu. The same editor is also under Settings → Profile.

FieldLimitsNotes
Display name1–50 charactersAny language. Leading and trailing spaces are removed.
Username3–20 charactersSame rules as at sign-up. Changing it changes your profile link.
BioUp to 280 charactersOptional. Line breaks are kept.
LocationUp to 60 charactersOptional. Free text; ArabDev never uses it for anything else.
WebsiteUp to 200 charactersOptional. If you leave out https:// it is added for you.
InterestsAny of the 25 topicsUsed for your feed and suggestions. See Tags and interests.

The Save button stays disabled until you change something. If a field has a problem, such as a taken username, the message appears under that field.

Changing your username

Your old profile link stops working and the old name becomes available to others. Links other people shared and @mentions in old posts still use the old name.

Profile pictures

  • Formats: JPEG, PNG, WebP or GIF.
  • Size: up to 5 MB.
  • Dimensions: at least 96×96 pixels, at most 8000 pixels on any side.
  • ArabDev crops the image to a centered square, resizes it to 400×400 pixels and saves it as WebP. Animated GIFs become still images.
  • Re-encoding removes hidden metadata such as the camera model and GPS location.
  • When you replace or remove a picture, the previous file is deleted from storage.

Followers and following lists

Open the lists from the counts on a profile, or go to /u/username/followers and /u/username/following. Each person is shown as a card with their bio, interests and a follow button. If someone has turned off Show my followers and following lists, other people see "This account keeps its connections private" instead. The owner can always see their own lists.

The home feed is the first page you see after signing in. It has three tabs, a quick way to start a post, and numbered pages rather than an endless scroll.

The three tabs

For you

The default tab, unless you chose another under Settings → Appearance → Feed to open first. It shows every post on ArabDev, recent posts first, ranked by a score that weighs three things:

  1. How close the post is to you. A post scores higher when you follow its author, when its tags match your interests, when you have liked or commented on the author's posts in the last 90 days, and when people you follow liked, reposted or commented on it.
  2. How much discussion it started. Likes count once, comments twice and reposts three times, on a scale that grows slowly, so a handful of reactions matters but a huge number does not bury everything else.
  3. How fresh it is. A post's score fades with every hour since it was published, so the feed keeps moving and yesterday's popular post does not stay on top for a week.

Two more rules keep the feed varied: the first five posts never hold more than two from the same person, and your own posts and posts you already liked sink a little, since you have seen them. Posts from the last 30 days are ranked this way; older posts follow, and no post is hidden. Posts from accounts that are suspended, and posts hidden while the moderators review a report, are left out of every feed.

Following

Only posts from you and the people you follow, plus the posts those people reposted. If several people you follow repost the same post, it appears once, at the time of the most recent repost, with a label such as "Omar Khatib reposted".

Latest

Every post, strictly newest first, with no ranking at all.

The tab you pick is kept in the address bar (for example /dashboard?tab=following), so reloading the page or sharing the link keeps the same view.

Pages instead of infinite scroll

ArabDev deliberately does not load posts endlessly as you scroll. The feed shows at most 20 posts per page. At the bottom you find:

  • Previous and Next buttons.
  • Numbered page links such as 1 2 3 … 20 on larger screens, or "Page 2 of 5" on phones.

The page number is part of the address (?page=2), so you can come back to exactly where you were. When you change page, the view returns to the top, and the previous page stays visible, slightly faded, until the next one arrives, so the screen never flashes blank.

Why pages?

Pages give the feed a natural end, make it easy to find a post again, and keep the app light: the server only ever sends 20 posts at a time.

What a post looks like in the feed

  • The author's picture, display name, @username and how long ago the post was published (hover to see the exact date and time). An "edited" note appears if the author changed it.
  • The title, or "by" and the author's name if the post has no title.
  • The beginning of the post. Long posts are cut at about 300 pixels with a gentle fade and a Read more link.
  • The attached image and link, if any, and the post's tags.
  • The action row: comment, repost, like, save and share, each with its count when it is above zero.
  • The ⋯ menu: copy the link, edit or delete your own post, or report someone else's.

Clicking anywhere on a post opens it, except on links, buttons and text you are selecting.

Starting a post from the feed

The box at the top of the feed ("What are you working on?") and the Write a post button both open the full post editor. See Writing posts.

Ads in the feed

Ads appear after the 3rd, 9th and 15th post of a page, and only when another post follows, so there are at most three per page. They are labelled and never look like posts. See Ads on ArabDev.

Main article: Ads on ArabDev.

When the feed is empty

  • If nobody has posted yet, you see "No posts yet" and a Create your first post button.
  • If the Following tab is empty, you see "Nothing from people you follow" and a button that takes you to Explore to find developers.

Posts are the heart of ArabDev: tutorials, questions, project announcements, tips and write-ups. The editor gives you everything a technical post needs, such as headings, code, tables and links, without turning into a word processor.

For every button and shortcut, see Formatting reference.

Opening the editor

Choose Create post in the navigation (the red + on phones), the Write a post button on the home feed, or open one of your drafts. The editor has:

  • A title field at the top (optional, up to 200 characters).
  • The toolbar, which stays pinned under the top bar while you scroll a long post.
  • The body, where you write.
  • Tags, an image and a link below the body.
  • A preview, next to the editor on large screens or behind a Preview tab on smaller ones.
  • Save draft and Publish buttons at the top.

Writing the body

The body is required: a post needs at least some text. Everything else is optional. You can use:

  • Paragraphs, headings and subheadings.
  • Bold, italic, underline, strikethrough and inline code.
  • Bulleted and numbered lists, including lists inside lists.
  • Quotes.
  • Code blocks for multi-line code.
  • Links inside the text.
  • Tables with an optional header row.
  • Text alignment (start, center, end, justify).
  • A choice of three fonts, six sizes and five colors.

The editor also accepts Markdown-style shortcuts as you type: ## and a space starts a heading, - and a space starts a list, ``` and a space starts a code block, and **bold** becomes bold.

Fonts, sizes and colors

ArabDev offers a small, deliberate set of choices so posts stay readable and consistent:

  • Fonts: Tajawal (the default body font), Alexandria (used for headings on ArabDev) and Anton (a tall display font, best for short emphasis).
  • Sizes: 14, 16, 18, 20, 24 and 30.
  • Colors: Red, Dark red, Ink, Graphite and Muted, plus the default text color.

Colors are not fixed values: each one has a light and a dark version, so a red phrase written in light mode is still easy to read for someone using dark mode.

Only these choices are kept

If you paste formatted text from another website, fonts, sizes and colors outside this set are removed when you publish. The words themselves are kept.

Writing in Arabic and English together

Each paragraph, heading, list item and table cell decides its own direction from its first letters. An Arabic paragraph flows right-to-left and an English one left-to-right in the same post. Code blocks are always left-to-right. "Start" and "end" alignment follow each paragraph's own direction, so "start" means right for Arabic and left for English.

Image and link attachments

Attaching an image

Choose Add image below the body. The image uploads immediately with a progress bar and then appears as a preview with a remove button. One image per post.

  • Formats: JPEG, PNG, WebP or GIF; up to 5 MB.
  • At least 64 pixels on the shorter side and at most 10,000 pixels on the longer side.
  • Large images are scaled down to fit within 1600×1600 pixels and saved as WebP. Animated GIFs become still images.
  • If you remove an image you just uploaded before saving, it is deleted from the server.

The Attach a link field is for the one link your post is about, such as a repository, a demo or an article. It appears under the post as a card showing the site's name and the full address. It must start with http:// or https:// and be at most 500 characters. For links inside your text, use the link button in the toolbar instead.

Tags

Add up to 5 tags to help people find your post. Type a tag and press Enter, pick a suggestion from the list, or paste several separated by commas. Each tag can be up to 30 characters.

Main article: Tags and interests.

Preview

The preview shows your post exactly as readers will see it: your picture and name, the title, the formatted body, the image, the link card and the tags. On screens 1200 pixels and wider it sits next to the editor and updates as you type. On smaller screens, switch between the Write and Preview tabs.

Drafts

  • Save draft stores everything, including the title, body, tags, image and link, without publishing.
  • Drafts autosave after a short pause. The editor address stays stable; open the saved item from Drafts to get its permanent address. Reload offers local recovery if available. Later saves update the same draft.
  • All your drafts are listed under Drafts in the account menu, most recently edited first, with a short excerpt and their tags.
  • Publishing from a draft turns it into a post and removes the draft.
  • Drafts are private. Nobody else can see or open them.

Leaving with unsaved changes

If you try to leave the editor with changes you have not saved, ArabDev asks "Discard your changes?" You can stay and keep editing, or leave and lose the changes. The browser shows a similar warning if you try to close the tab.

Publishing

Choose Publish. If the body is empty you see "Write something before publishing"; if the attached link is not valid, the message appears under the link field. Once published, you are taken to your new post. You can publish up to 30 posts per hour.

Editing and deleting posts

  • Open the ⋯ menu on your post and choose Edit post. You can change everything: title, body, tags, image and link. The post then shows an "edited" note.
  • Choose Delete post from the same menu. ArabDev asks you to confirm, because deleting also removes the post's comments, likes, reposts and bookmarks. This cannot be undone.
  • If an image is no longer used by any post or draft after an edit or deletion, the file is deleted.
  • Copy link in the same menu works on anyone's post.

Mentioning people

Write @username anywhere in a post to mention someone. They get a notification (unless their settings say otherwise). Up to 10 different people are notified per post.

What happens to your post when you publish

The server checks and cleans every post before saving it. It keeps only the formatting the editor offers and removes anything else, including scripts, unknown tags, styles outside the allowed fonts, sizes and colors, and links that do not use http, https or mailto. Links in posts open in a new tab and are marked so search engines do not treat them as endorsements. The browser checks the post again before showing it. This double check keeps everyone who reads your post safe.

A complete list of the editor's toolbar buttons, keyboard shortcuts and Markdown-style shortcuts. On Mac, use ⌘ wherever this page says Ctrl.

Toolbar, from start to end

ControlWhat it does
Undo / RedoStep backward or forward through your changes. Greyed out when there is nothing to undo or redo.
Text styleParagraph, Heading or Subheading for the current block.
FontDefault font, Alexandria, Tajawal or Anton for the selected text. Each option is shown in its own font.
SizeDefault, 14, 16, 18, 20, 24 or 30 for the selected text.
BoldMakes the selected text bold.
ItalicMakes the selected text italic.
UnderlineUnderlines the selected text.
StrikethroughDraws a line through the selected text.
Inline codeFormats a short piece of code inside a sentence, like npm install.
Text colorOpens a menu: Default, Red, Dark red, Ink, Graphite, Muted. Each option is shown in its color.
Align to start / Center / Align to end / JustifySets the alignment of the current paragraph or heading. Choosing the active alignment again removes it.
Bulleted listTurns the paragraph into a bulleted list, or back.
Numbered listTurns the paragraph into a numbered list, or back.
QuoteTurns the paragraph into a quote, shown with a red bar at its start.
Code blockStarts a block for multi-line code, shown on a dark background, always left-to-right.
LinkOpens a dialog to add, change or remove a link on the selected text. Addresses without https:// get it added.
TableOutside a table: insert a new table. Inside a table: add or delete rows and columns, or delete the table.

Buttons for formatting that is active where your cursor is are highlighted, so you can always see which styles apply. On narrow screens the toolbar scrolls sideways instead of wrapping onto several lines.

Keyboard shortcuts

ShortcutAction
Ctrl + BBold
Ctrl + IItalic
Ctrl + UUnderline
Ctrl + Shift + SStrikethrough
Ctrl + EInline code
Ctrl + Alt + 2 / 3Heading / Subheading
Ctrl + Shift + 8Bulleted list
Ctrl + Shift + 7Numbered list
Ctrl + Shift + BQuote
Ctrl + Alt + CCode block
Ctrl + ZUndo
Ctrl + Shift + Z or Ctrl + YRedo
Shift + EnterLine break inside the same paragraph
Tab / Shift + Tab in a listIndent / outdent the list item
Tab in a tableMove to the next cell; in the last cell, add a new row
Ctrl + Enter in a commentSend the comment

Markdown-style shortcuts

Type these at the start of an empty line (for blocks) or around text (for inline styles). They turn into formatting as you type.

TypeResult
## then spaceHeading
### then spaceSubheading
-, * or + then spaceBulleted list
1. then spaceNumbered list (starting at that number)
> then spaceQuote
``` then spaceCode block (you can add a language name, for example ```python)
---Horizontal divider
**text**Bold
*text* or _text_Italic
~~text~~Strikethrough
`text`Inline code

Typing or pasting a web address followed by a space turns it into a link automatically. Pasting an address while text is selected links that text.

Working with tables

  1. Choose the table button while your cursor is outside a table.
  2. Set the number of rows (1–20) and columns (1–8) and whether the first row is a header row.
  3. Choose Insert table.
  4. With the cursor inside the table, the same button opens a menu: Add row below, Add column after, Delete row, Delete column and Delete table.

Wide tables scroll sideways on small screens instead of squeezing their content. Header cells are shown in bold on a tinted background.

  • Allowed kinds of address: https://, http:// and mailto:.
  • Anything else, such as javascript:, is refused by the editor and removed by the server.
  • To remove a link, place the cursor on it, open the link dialog and choose Remove link, or clear the address and save.

Color meanings

ColorSuggested use
RedThe ArabDev red: warnings, key terms, emphasis.
Dark redA calmer emphasis for longer phrases.
InkMaximum contrast, for example to stand out inside muted text.
GraphiteSecondary information.
MutedAsides, footnotes and "optional" remarks.

Do not rely on color alone to carry meaning: some readers cannot tell colors apart. Pair color with words such as "Warning:".

Tags describe what a post is about. Interests describe what a person works with. ArabDev connects the two: when a post's tag matches one of the 25 interests, the post counts as being about that interest, which shapes the For you feed and developer suggestions.

How tags are written

You can type tags however you like, and ArabDev turns each one into a tidy tag name:

  • A leading # is removed.
  • Letters become lower-case.
  • Spaces, underscores, dots and slashes become hyphens, and repeated hyphens are merged.
  • + becomes p and # becomes sharp, so C-family languages stay distinct.
  • Arabic letters are kept, so #برمجة is a valid tag.
  • Well-known spellings are merged into one tag (see the table below).
  • Duplicate tags on the same post are kept once, and up to 5 tags are kept per post.

Spellings that are merged

You typeTag
jsjavascript
tstypescript
c++cpp
c#csharp
.netdotnet
node, node.jsnodejs
golanggo
mlmachine-learning
security, infoseccybersecurity
sql, databasedatabases
gamedevgame-development
mobilemobile-development
ui, ux, uiux, ui/uxui-ux
opensource, ossopen-source
vuejs, vue.jsvue
reactjs, react.jsreact

The 25 interests

InterestTagArabic name
JavaScriptjavascriptJavaScript
TypeScripttypescriptTypeScript
PythonpythonPython
C++cppC++
RustrustRust
GogoGo
JavajavaJava
C#csharpC#
ReactreactReact
VuevueVue
AngularangularAngular
Node.jsnodejsNode.js
FastAPIfastapiFastAPI
DjangodjangoDjango
AIaiالذكاء الاصطناعي
Machine Learningmachine-learningتعلّم الآلة
Cybersecuritycybersecurityالأمن السيبراني
LinuxlinuxLinux
DevOpsdevopsDevOps
Cloudcloudالحوسبة السحابية
Databasesdatabasesقواعد البيانات
Game Developmentgame-developmentتطوير الألعاب
Mobile Developmentmobile-developmentتطوير تطبيقات الجوال
UI/UXui-uxتصميم الواجهات UI/UX
Open Sourceopen-sourceالمصادر المفتوحة

Programming languages and frameworks keep their original names in the Arabic interface, because that is how developers write them.

Tag pages

Every tag has a page at /tags/name listing its posts, newest first, 20 per page, with how many posts use it. You reach tag pages by clicking a tag on a post, an interest chip on a profile, a popular tag, or a tag in search results.

The Popular tags list (in the side column and on Explore) ranks tags by how many posts used them in the last 30 days. If no posts were tagged in that time, it falls back to the all-time ranking. The list is refreshed every two minutes. The top three ranks are shown in red.

RSS feeds

If you use a feed reader, you can follow ArabDev without an account:

  • arabdev.site/rss.xml: the latest posts on the site.
  • arabdev.site/tags/name/rss.xml: posts with one tag, for example /tags/python/rss.xml.
  • arabdev.site/u/username/rss.xml: one person's posts. Accounts that turned off Show me in search and suggestions have no feed.

Each feed holds the 20 newest posts, with their title and opening lines. Profile and tag pages announce their feed, so most readers find it if you paste the page's address.

Under every post is an action row with five buttons: comment, repost, like, save and share. This article covers each of them.

Likes

The heart button likes a post; select it again to unlike. The heart fills in and turns red when you have liked a post, and the count updates immediately. The author gets a notification, and if you unlike before they read it, the notification is withdrawn.

Reposts

  • The repost button shares someone else's post with your followers. It appears in their Following feed with a label such as "Layla Hassan reposted" and on your profile's Posts tab.
  • Select it again to undo the repost.
  • You cannot repost your own posts, so the button is disabled on them.
  • The author gets a notification.

Bookmarks (saved posts)

The bookmark button saves a post for later. Saved posts are listed on the Bookmarks page and on the Saved tab of your own profile, newest save first. Bookmarks are completely private: nobody, including the author, is told or can see who saved a post.

Sharing

The share button opens your device's share sheet where available (most phones). Otherwise it copies the post's link and shows "Link copied".

Comments

Comments appear on the post's page under Discussion, oldest first, so conversations read from top to bottom. Twenty comments are shown per page.

Writing a comment

  • Type in the box under the post and choose Comment, or press Ctrl + Enter.
  • Comments are plain text of 1 to 2000 characters. Line breaks are kept. A counter shows how much you have written.
  • Arabic and English comments each align correctly on their own.
  • After posting, the list jumps to the page with your new comment.

Replying

Choose Reply on a comment. A "Replying to @username" chip appears above the box; remove it to cancel the reply. Replies are shown in order with a "Replying to @username" note. The person you reply to is notified.

Mentions in comments

Write @username to mention someone. Mentions become links to their profiles and stay readable inside Arabic sentences. Mentioned people are notified, except those already notified about the same comment (for example the post's author).

Deleting comments

A comment can be deleted by its author, by the author of the post it is on, and by ArabDev administrators. Deleting a comment also deletes the replies to it, and the post's comment count is recalculated.

Without an account

Anyone can read public posts and comments. If you are not signed in and select like, repost or save, ArabDev asks you to sign in and brings you back to the post afterwards.

Limits

To prevent abuse, each network can make up to 300 likes, saves and reposts per hour, and up to 60 comments per 10 minutes. Normal use never comes close.

Following someone puts their posts and reposts in your Following feed and ranks them higher in For you. This article explains following, how ArabDev suggests people, and the Explore page.

Following and unfollowing

  • Select Follow on a profile, a suggestion card or a post page.
  • The button changes to Following. Hovering over it (or focusing it with the keyboard) changes the label to Unfollow in red, and selecting it then unfollows. The label changes as well as the color.
  • The person gets a "started following you" notification. If you unfollow before they read it, it is withdrawn.
  • You cannot follow yourself.
  • Following is public: it is shown in both people's lists unless they have made their lists private.

How suggestions work

"Developers to follow" appears in the side column, on Explore and in the last step of setup. Each candidate gets a score:

  • 3 points for each interest you share with them.
  • 2 points for each person you follow who also follows them.

Candidates with the same score are ordered by how many followers they have, then by who joined most recently. ArabDev never suggests you to yourself, people you already follow, deactivated accounts, or anyone who turned off Show me in search and suggestions. Visitors who are not signed in see the most-followed developers.

The Explore page

Explore is open to everyone, signed in or not. It contains:

  • A search box. See Search.
  • Trending: choose a week, month or all-time range. Explore ranks posts in that range by weighted engagement (likes, twice the comments and three times the reposts), with newest posts breaking ties. An empty range stays empty. Results are paginated, 20 per page.
  • Popular tags and developers to follow. On large screens these live in the side column; on smaller screens they appear at the top of Explore.

ArabDev searches posts, developers and tags from one box: in the top bar on large screens, behind the magnifying glass on phones, and on the Explore and Search pages.

Live suggestions

After you type two characters, ArabDev waits a moment (300 milliseconds) for you to stop typing, then shows suggestions grouped into Developers, Tags and Posts, up to five of each, and a final "See all results" line.

  • ↓ and ↑ move through the suggestions.
  • Enter opens the highlighted suggestion, or runs a full search if none is highlighted.
  • Esc closes the list.
  • The × button clears the box.

What is searched

GroupMatchesOrder
PostsThe title and the text of the bodyNewest first
DevelopersUsername and display nameExact username match first, then newest members
TagsTag nameMost-used first

Developers who turned off Show me in search and suggestions are left out of developer results, unless you type their exact username.

Search tips

  • Start with @ to look for people: @layla.
  • Start with # to look for tags: #rust.
  • Search is not case-sensitive, and characters such as % and _ are searched literally, so 100% finds exactly that.
  • Searches can be up to 100 characters long.

The results page

Pressing Enter or choosing "See all results" opens /search?q=…. Its tabs are All, Posts, Developers and Tags. All shows a short preview of each group with a "View all" button, and the other tabs show the complete list, 20 per page. If nothing matches, ArabDev suggests checking the spelling, trying a shorter phrase or searching for a tag.

Notifications tell you when people interact with you. They appear on the Notifications page, and a red badge with the number of unread notifications appears on the Notifications item in the navigation.

Kinds of notifications

KindYou are notified when…
Likesomeone likes your post.
Commentsomeone comments on your post, or replies to your comment on someone else's post.
Followsomeone starts following you.
Repostsomeone reposts your post.
Mentionsomeone writes your @username in a post or comment.

How notifications behave

  • You are never notified about your own actions.
  • Liking, following or reposting the same thing again does not create duplicate notifications.
  • If someone undoes a like, follow or repost before you have read the notification, it disappears.
  • If one comment both replies to you and mentions you, you get one notification, not two.
  • The unread badge refreshes every 30 seconds while ArabDev is open; the Notifications page refreshes every minute.

Reading notifications

Unread notifications have a tinted background, a bold name and a red dot with the word New, so they stand out without relying on color alone. Each shows who acted, what they did, the post title and, for comments, the comment itself. Selecting a notification marks it as read and opens the post or profile. Mark all as read clears every unread notification at once. Notifications are listed newest first, 20 per page.

Choosing what you are notified about

Go to Settings → Notifications to turn each kind on or off. Turning a kind off stops new notifications of that kind; ones you already have stay. To control who can notify you with a mention, see Settings → Privacy.

No email notifications

ArabDev does not send notifications by email. The only emails it sends are password reset links you ask for.

Settings are grouped into six sections: Account, Profile, Security, Appearance, Privacy and Notifications. On large screens the sections are listed on the side; on phones they are tabs across the top. Switches save as soon as you change them and show "Settings saved"; if saving fails, the switch returns to its previous position and an error explains why.

Account

Username

Shows your current username. The Edit link takes you to the Profile section, where you can change it.

Email

Your current address is shown with a Confirmed or Not confirmed badge. To change it:

  1. Enter the new address and your current password, then choose Update email. The password is required so that someone using your unlocked device cannot take over your account.
  2. ArabDev emails a six-digit code to the new address. Enter it within 10 minutes. This proves the new inbox is yours and that you typed it correctly.
  3. The address changes, and your old address receives an email saying so, so a change you did not make never goes unnoticed.

The new address must not belong to another account. Until the code is entered, nothing changes. See Confirmation codes.

Password

Enter your current password, a new one and the new one again. The new password must follow the password rules and differ from the current one. ArabDev then emails a six-digit code to your address; the new password takes effect only when you enter it. Changing your password signs you out everywhere else, you stay signed in on the device you used, and you receive an email confirming the change.

Deleting your account

Delete my account permanently removes your account after you confirm with your password. Your posts, comments, replies, likes, reposts, bookmarks, follows, drafts, notifications and uploaded files are all deleted, and the counts on other people's posts are updated. This cannot be undone. If you want to keep a copy of your work, use Download my data first.

Profile

The same editor as Edit profile: picture, display name, username, bio, location, website and interests. See Editing your profile.

Security

Signing in

SettingWhen on (default)When off
Email me a code when signing inEvery sign-in is confirmed with a six-digit code sent to your email, so a stolen password alone is not enough.Your password is enough to sign in. Creating an account and changing your email or password still need a code.
Tell me about account changesYou get an email when your password changes or a new browser signs in.No such emails. A notice to your old address when your email changes is always sent.
Tip

Keep both switched on. They are the two things most likely to stop someone who has learned your password.

Authenticator app

Shows whether an authenticator app is on and, when it is, how many recovery codes you have left. Set up walks you through adding one; New recovery codes and Turn off appear once it is on. See Authenticator app.

Where you are signed in

A list of every browser that currently holds a sign-in to your account: the browser and system (for example "Chrome · Android"), a phone or computer icon, and when it signed in. The browser you are using is marked This device.

  • Sign out next to any other entry ends that session straight away. Its next request fails and it has to sign in again, with a code.
  • Sign out everywhere else ends every session except this one.

If you see a browser you do not recognise, sign it out and change your password.

Your data

Download my data saves one JSON file with everything your account holds: your account details, profile, settings, interests, posts, drafts, comments, the posts you liked and saved, and the people you follow. Downloading changes nothing. Passwords, session tokens and other people's private information are never included. You can download it five times an hour.

The file also lists the accounts you blocked, the reports you sent, and whether the authenticator app is on.

Appearance

  • Theme: Light, Dark or System. System follows your device and switches automatically when your device does.
  • Language: العربية or English. The whole layout changes direction with the language: right-to-left for Arabic, left-to-right for English.
  • Feed to open first: For you (default), Following or Latest. The home page opens on this tab; the other tabs are one tap away.
  • Reduce animation: keeps fades and transitions to a minimum across the site, whatever your device is set to. See Accessibility and languages.

When you are signed in, these choices are saved to your account and applied when you sign in on another device. The theme and language switches are also in the account menu.

Privacy

SettingWhen on (default)When off
Show me in search and suggestionsYou can appear in developer search, "Developers to follow" and the list of profiles offered to search engines.You are left out of all three. People can still open your profile from a direct link, your posts, or by typing your exact username.
Show my followers and following listsAnyone can open your lists.Only you can see your lists. The counts stay visible.

Who can notify you with a mention has three choices: Everyone (default), People you follow and No one. It controls mention notifications only; it does not stop people from writing your name.

Blocked accounts

Everyone you blocked, with an Unblock button next to each. See Blocking.

Notifications

Five switches, all on by default: likes on your posts, comments and replies, new followers, reposts of your posts, and mentions.

Email

  • Tell me about account changes: the same switch as under Security.
  • What changed in ArabDev: an occasional note when a release adds something worth knowing about. Off by default.

ArabDev never sends marketing email, and your address is never shared or sold.

This article is a practical summary. The full, binding text is the ArabDev Privacy Policy.

Our promise

ArabDev does not sell, rent or trade your personal information, and it does not use it to target ads. ArabDev runs no analytics or tracking scripts of its own; the only outside code is Google’s ad script, which is asked for non-personalised ads, and Cloudflare’s security check. See Ads on ArabDev and The security check.

What is public and what is private

InformationWho can see it
Username, display name, picture, bio, location, website, interests, join dateEveryone, including people without an account
Posts, comments and repostsEveryone
Follower and following listsEveryone, unless you turn them off (then only you)
Like, comment and repost countsEveryone
Which posts you likedYou, and the post's author through notifications
Email addressOnly you
BookmarksOnly you
DraftsOnly you
Notifications and settingsOnly you
PasswordNobody. It is stored only as a one-way hash.

What ArabDev keeps in your browser

NameKindPurpose
arabdev_refreshCookie (HttpOnly)Keeps you signed in. Scripts cannot read it, and it is only sent to the sign-in endpoints.
arabdev.langLocal storageYour interface language.
arabdev.modeLocal storageLight, dark or system theme.
arabdev.sessionLocal storageA yes/no hint that this browser has signed in, so visitors are not sent an unnecessary sign-in check.
mui-color-scheme-light, mui-color-scheme-darkLocal storageWritten by the interface library to remember which palette belongs to light and dark mode.
react-router-scroll-positionsSession storageRemembers your scroll position when you go back. Cleared when the tab closes.

That is the complete list of what ArabDev itself stores. ArabDev sets no advertising or analytics cookies; Google (for the ads) and Cloudflare (for the security check) may store their own, as the Privacy Policy explains.

Images and hidden metadata

Photos taken on phones often carry hidden information such as the date, the camera and the GPS location. ArabDev re-encodes every uploaded image into a new file, which leaves that information behind. Only the picture itself is stored and shown.

Your controls

  • Hide yourself from search and suggestions. See Settings → Privacy.
  • Make your follower and following lists private.
  • Choose who can notify you with mentions.
  • Turn off any kind of notification.
  • Edit or delete any post or comment you wrote.
  • Delete your account and everything in it. See Deleting your account.

Blocking

Block an account from the ⋯ menu on its profile or on any of its posts. After that:

  • Neither of you can follow the other, comment on the other's posts, reply to the other's comments or repost the other's posts.
  • No notification goes between you. The follows between you are removed in both directions, along with the notifications they had sent you.
  • You stop seeing their posts and comments, and they are no longer suggested to you.
  • They aren't told. If they open your profile they can still read your public posts, as anyone can without an account.

Unblock from the same menu, or from Settings → Privacy → Blocked accounts. Unblocking doesn't bring back the old follows.

Staying safe

  • Never share your password. ArabDev staff will never ask for it.
  • Think before posting anything personal. Posts are public and can be read by anyone.
  • Do not post API keys, tokens or passwords in code samples. Replace them with placeholders.
  • Links in posts lead to other websites that have their own privacy practices.

How ArabDev protects your account, and what you can do to help.

How passwords are stored

ArabDev never stores your password. It stores a one-way hash made with Argon2id, a method designed to be slow and memory-hungry for anyone trying to guess passwords. Even the people running ArabDev cannot see your password. When you sign in, ArabDev hashes what you typed and compares the results.

Confirmation codes

A password can be guessed, reused from another site or read over someone's shoulder. So the actions that matter most are confirmed with a six-digit code sent to your email:

  • Creating an account. The account is created only once the code is entered, so a mistyped address cannot leave behind an account nobody can reach.
  • Signing in, unless you switched this off under Settings → Security.
  • Changing your email. The code goes to the new address.
  • Changing your password. The new password takes effect only when the code is entered.

The screen shows which inbox to check, partly hidden (for example l***a@example.com), and a countdown. The code:

  • arrives from noreply@arabdev.site, with the code at the start of the subject line;
  • is valid for 10 minutes and works once;
  • allows five tries; after that, start again;
  • can be sent again after 60 seconds, up to four times. Only the newest code works.

Typing the sixth digit submits the code; you do not need to press a button. ArabDev stores only a keyed hash of each code, never the code itself.

Never share a code

ArabDev will never ask you for a code or your password, by email, message or anywhere else. If someone asks, it is an attempt to take over your account.

Security alerts

ArabDev emails you when your password changes and when a new browser signs in, with the browser and network address it used, so you can tell whether it was you. When your email address changes, the old address is always told. You can switch the other alerts off under Settings → Security.

Authenticator app

An authenticator app on your phone makes a new six-digit code every 30 seconds. With one turned on, signing in needs your password and the code the app shows at that moment, so someone who learns your password still can't get in. ArabDev works with Google Authenticator, Microsoft Authenticator, 1Password, Authy and any other app that supports standard time-based codes (TOTP).

Turning it on

  1. Go to Settings → Security and choose Set up next to Authenticator app.
  2. Enter your password.
  3. Scan the QR code with the app. If you can't scan it, add the account by hand with the key shown under it.
  4. Type the six-digit code the app shows, and choose Turn on.
  5. Save the ten recovery codes that appear: copy them, download them as a file, or write them down. You won't see them again.

From then on, after your password ArabDev asks for the code from your app instead of emailing you one. You get five tries; after that, start signing in again. A code that has already been used is refused, even before it changes in the app.

Recovery codes

Each recovery code gets you in once, in place of the app's code, if you lose your phone or it is reset. Settings shows how many you have left. New recovery codes makes a fresh set of ten and cancels the old ones. Recovery codes are stored only as one-way hashes, so ArabDev can't show them to you again.

Turning it off

Choose Turn off under Settings → Security and enter your password and a code from the app (or a recovery code). Your recovery codes are deleted, and signing in goes back to emailed codes if you have those switched on.

With account alerts on (they are by default), ArabDev emails you when the app is turned on or off, when a recovery code is used, with how many are left, and when new recovery codes are made.

Leaked passwords

Passwords stolen from other sites end up in lists that attackers try everywhere. When you choose a new password, ArabDev checks it against the Have I Been Pwned list of passwords from public breaches and refuses it if it is there, with the message "This password has turned up in a data breach". Your password is not sent: only the first five characters of its SHA-1 hash are, and the comparison happens on ArabDev's server. If the list can't be reached, the password is accepted.

The security check

Cloudflare Turnstile checks that a real browser, not a script, is sending a request. Signing in, signing up, resetting a password, changing your email or password, publishing and commenting each get a check of their own. Everything else you do while signed in (likes, saves, reposts, follows, blocks, reports, uploads, drafts, edits and profile changes) is covered by a check that runs in the background about once every 30 minutes. For almost everyone all of this is invisible. Once in a while Cloudflare shows a small box to tick, above a button or at the bottom of the screen.

  • Each pass from Turnstile is used once and expires after five minutes, and ArabDev checks it with Cloudflare before doing anything. The background check is traded for a 30-minute pass that works only for your account; signing out everywhere or changing your password cancels it.
  • If you see "Please complete the security check and try again" or "We couldn't confirm you're not a robot", reload the page and try again. Strict privacy extensions or blocked scripts from challenges.cloudflare.com can stop the check from running.
  • Turnstile does not tell ArabDev who you are, and its result is not stored.

How sessions work

  • When you sign in, your browser receives a short-lived access pass that lasts 15 minutes and is kept only in the page's memory, never in storage.
  • A longer-lived sign-in cookie renews that pass automatically. The cookie is HttpOnly, so scripts on the page cannot read it, and it is only sent to ArabDev's sign-in endpoints.
  • Every renewal replaces the cookie with a new one. If an old cookie is ever used again, which is a sign it was copied, ArabDev ends that whole session. A short grace period prevents this from happening by mistake when two tabs renew at the same moment.
  • The server stores only a hash of each sign-in cookie, the browser description, and when it was created and when it expires.
  • You can see every signed-in browser under Settings → Security → Where you are signed in, and end any of them.

Signing out

Choose Sign out from the account menu. This ends the session on that browser and removes the sign-in cookie. To sign out somewhere else, use Where you are signed in. Changing your password or resetting a forgotten password signs you out of every other browser too.

Resetting a forgotten password

  1. On the sign-in page choose Forgot password?
  2. Enter the email address you signed up with and choose Send reset link.
  3. ArabDev always answers the same way, whether or not the address has an account, so nobody can use this form to find out who is registered.
  4. Open the link in the email within 30 minutes. It works only once. Each inbox receives at most five reset emails an hour.
  5. Choose a new password. All your existing sessions are signed out, you receive an email confirming the change, and you can sign in with the new password.

Protection against guessing and abuse

ArabDev limits how often sensitive actions can be repeated. When a limit is reached you see "Too many attempts. Wait a moment and try again." The limits are shared by all of ArabDev's servers, and the network address they count is the one ArabDev's own hosting recorded, which a visitor cannot fake.

ActionLimit per network
Sign in10 per minute
Create account10 per hour
Enter a confirmation code20 per 5 minutes
Send another code10 per 15 minutes
Forgot password5 per 15 minutes
Reset password10 per 15 minutes
Change email10 per 15 minutes
Change password10 per 15 minutes
Delete account10 per 15 minutes
Download my data5 per hour
Username and email availability checks60 per minute
Session renewal60 per minute
Publish a post30 per hour
Comment60 per 10 minutes
Like, save and repost300 per hour
Follow120 per hour
Upload an image30 per 10 minutes
Search120 per minute
Report a post10 per hour

Some limits also apply to each account, however many networks the attempts come from:

ActionLimit per account
Sign in8 attempts per 15 minutes
Password reset emails5 per hour for each inbox
Wrong confirmation codes5 per code
Reports20 per day

Other protections

  • Every request that changes something is checked on the server. The buttons you see in the app are for convenience; permission is always decided by the server.
  • Post content is cleaned on the server and again in the browser. See What happens to your post when you publish.
  • Uploads are decoded as images and re-encoded; any other kind of file is refused. An image's size is read from its header first, so an oversized image is refused before it is ever decoded.
  • Every page is sent with security headers: browsers must use HTTPS, no other website can show ArabDev inside a frame, plugins and forms that post elsewhere are blocked, files are never guessed as another type, and camera, microphone, location and payment access are switched off.

Tips

  • Turn on an authenticator app, and keep the recovery codes somewhere other than your phone.
  • Use a unique password for ArabDev and keep it in a password manager.
  • Keep Email me a code when signing in and the account alerts switched on.
  • Protect the email account itself with its own two-step verification: whoever reads your inbox can confirm codes.
  • Uncheck "Keep me signed in" on shared or public computers, and sign out when you are done.
  • Check Where you are signed in now and then. If you think someone else knows your password, change it: that signs every other device out.

ArabDev shows ads to pay for its servers. Most come from Google AdSense; sponsors who deal with us directly and ArabDev's own notices fill the rest. They have fixed places, are always labelled, and are never put inside posts or comments.

Where ads appear

  • Homepage: one ad after the latest posts and, on screens wide enough for it, a 728×90 banner near the bottom.
  • Feeds: after the 3rd, 9th and 15th post of a page, and only when another post follows, so a page never ends on an ad.
  • Side column: one ad, on large screens.
  • A post's page: one ad between the post and its comments.
  • Automatic placements: Google may place a few ads of its own elsewhere on the page, such as a bar along the edge of the screen. Google marks these as ads itself.
  • Never inside content: no ads inside posts or comments, and no ads made to look like posts.

How to recognise an ad

  • Google ads sit in a frame labelled Advertisement.
  • Sponsor ads and ArabDev's own notices are labelled Sponsored, say who is promoting them, and have an information icon explaining why the ad is there. They have no profile picture or buttons, so they can't be mistaken for posts.

How ads are chosen

  • Google ads are requested in non-personalised mode. Google chooses them by the content of the page and your approximate region, never by a profile of what you read or who you are.
  • Direct sponsor and ArabDev ads are chosen only by where they appear, your interface language and the page number, which rotates them predictably.

ArabDev never gives your account information to Google or to any advertiser. Your name, username, email, interests, posts, likes and follows stay with ArabDev. Because Google's ad code runs in your browser, Google can see what any website can, such as your IP address and the page you are on; see the Advertising section of the Privacy Policy.

What is counted

For direct sponsor and ArabDev ads, ArabDev keeps two totals: how many times each was shown and how many times it was clicked. Google counts views and clicks of its own ads to pay ArabDev, and ArabDev sees only those totals. None of these numbers are linked to you or to any account.

When Google has no ad

Google doesn't always have an ad for every place. If it has none, or hasn't answered within six seconds, the place in the feed or the side column shows a sponsor's ad or one of ArabDev's notices instead (for example, an invitation to share an open-source project); anywhere else the space simply closes. ArabDev's notices are labelled "Promoted by ArabDev". To sponsor ArabDev, write to hi@arabdev.site.

If you use an ad blocker

That is your choice. ArabDev works the same with ads blocked and never hides anything behind them. If a blocker also stops Cloudflare's security check, sign-in and posting may ask you to try again; see The security check.

ArabDev works best when it stays technical, generous and respectful. These guidelines describe what that means in practice.

Do

  • Share what you learn, including small tips and honest mistakes.
  • Explain the "why", not only the "how". Include versions, context and trade-offs.
  • Credit the work you build on: link to original authors, projects and documentation.
  • Give feedback on the code and the idea, not the person.
  • Welcome beginners. Everyone asked a first question once.
  • Write in whichever language serves your readers best: Arabic, English or both.
  • Use tags that describe the post, so the right people find it.

Do not

  • Harass, insult, threaten or target anyone, for any reason.
  • Post hateful content about people's origin, religion, gender, disability or any other part of who they are.
  • Post spam, repeated self-promotion, link farms or misleading titles.
  • Share other people's private information.
  • Share malware, exploits aimed at systems you do not own, or stolen credentials.
  • Post content that is illegal, or that infringes someone's copyright or trademark.
  • Impersonate other people, companies or ArabDev.

New accounts and spam

Most spam comes from accounts made minutes before it is posted, so a new account has a few limits during its first day:

  • Up to 5 posts and 20 comments an hour.
  • Up to 2 links in a post, a comment or the bio, and none straight to a program to download (such as an .exe or .apk file) or to a bare IP address. A link to a project's page or its releases is fine.

For every account, the same post twice within a day is refused, and so is the same comment unless it is a short one like "Thanks!". Sign-ups with temporary inboxes such as Mailinator or 10 Minute Mail are refused too. Moderators are exempt from these limits.

Security research

Discussing vulnerabilities, defensive techniques and how attacks work is welcome, because it is how developers learn to build safer software. Publish details about a specific, unpatched vulnerability in someone else's product only after giving them a reasonable chance to fix it. If you find a security problem in ArabDev itself, report it privately to support@arabdev.site rather than posting it (see Reporting a security problem).

Reporting a post

If a post breaks these guidelines, open its ⋯ menu and choose Report post. Pick the reason that fits best (spam or advertising, harassment or bullying, hate speech, sexual content, violence or threats, false or misleading information, someone's private information, copyright infringement, or something else) and, if you like, add a few words for the moderators. You need to be signed in, and you cannot report your own posts.

  • The author gets an email saying the post was reported and why. It never says who reported it.
  • The ArabDev team gets an email with the details and a link to review the report.
  • Reporting the same post again changes nothing; each person counts once.
  • When three eligible accounts (verified, at least seven days old, unrestricted, and with fewer than three dismissed reports in 90 days) have reported a post, it is hidden from everyone except its author and the moderators until the team decides. The author is told by email and sees a notice on the post.
  • When the team decides, the author and everyone who reported the post receive an email with the outcome.

Each account can send up to 20 reports a day. Reports are for guideline problems, not disagreements: if you simply disagree with a post, reply to it or scroll past.

Moderation

Post authors can delete comments on their own posts. For reported posts, an ArabDev moderator reviews every report about the post together and decides:

  • Keep the post. Nothing breaks the guidelines. If the post was hidden, everyone can see it again.
  • Remove the post. It is deleted for everyone, with its comments and likes.
  • Restrict the author for 1, 3, 7, 30, 90 or 365 days. A restricted account can still sign in, read, like and save posts, but cannot publish, comment or repost until the date shown at the top of every page.
  • Suspend the account. The person is signed out everywhere, cannot sign in, and their posts are no longer shown.

A moderator can combine removing the post with a restriction or a suspension, and can add a short note that is emailed to the author with the decision. Moderators cannot restrict or suspend another moderator. If you think a decision was a mistake, write to support@arabdev.site and the team will look at it again; restrictions and suspensions can be lifted early.

ArabDev aims to be usable by everyone, with any input method and in either of its languages.

Arabic and English

  • Arabic is the default. Switch with the language control in the top bar (when signed out), in the account menu, or under Settings → Appearance.
  • Changing the language flips the entire layout: navigation, menus, drawers, arrows, spacing and text alignment all follow the new direction at once.
  • Icons with a direction, such as back arrows, pagination arrows and undo, are mirrored in Arabic.
  • Numbers are shown with Western digits (0–9) in both languages, which developers read most easily next to code.
  • Dates and relative times ("3 hr. ago", "منذ 3 ساعات") are written in the interface language.
  • Arabic grammar for counts is handled properly: one, two, a few and many each have their own wording.

Keyboard use

  • A Skip to content link appears when you first press Tab.
  • Every button, link, menu and form field can be reached and used with the keyboard, and shows a clear red outline when focused.
  • Search suggestions follow the standard combobox pattern: arrow keys, Enter and Esc.
  • Dialogs keep focus inside them until closed.

Screen readers

  • Icon-only buttons have spoken names, such as "Like (4)" or "Remove from saved".
  • Toggle buttons such as like, save and follow announce whether they are on.
  • Images attached to posts are described as attached images, together with the post title.
  • Loading areas are marked as busy, and status messages such as "Link copied" are announced.

Seeing the interface

  • Text and buttons meet common contrast guidelines in both light and dark mode.
  • State is never shown by color alone. Unread notifications also have a "New" label, and selected interests have a check mark.
  • If your device asks for reduced motion, ArabDev turns animations off. You can also switch on Reduce animation under Settings → Appearance, which works on any device and follows your account.
  • The layout works from small phones to wide screens, and you can zoom in without losing content.

Account

Is ArabDev free?

Yes. ArabDev is free to use, and its source code is free software under the GNU General Public License v3.

Can other people see my email address?

No. Your email address is only used to sign in, to send you confirmation codes and security alerts, and to reset your password.

Can I change my username?

Yes, under Settings → Profile or Edit profile. Your profile address changes with it. See Editing your profile.

Why can't my username be in Arabic?

Usernames are used in addresses and @mentions, so they are limited to English letters, numbers and underscores to keep them easy to type everywhere. Your display name can be in Arabic.

How do I delete my account?

Settings → Account → Delete my account. You confirm with your password, and everything is removed permanently.

I lost the phone with my authenticator app. How do I sign in?

Type one of your recovery codes where the app's code goes; each one works once. Once you are in, turn the app off and on again under Settings → Security to set up your new phone, or make a new set of recovery codes. If you have no recovery codes left, write to support@arabdev.site from the account's email address. See Authenticator app.

Posting

Does a post need a title?

No, but it helps people decide whether to read it. Without a title, the post is shown as "by" and your name.

How many images can I add to a post?

One attached image per post.

Why did my pasted colors disappear?

ArabDev keeps only its own five text colors, three fonts and six sizes so posts stay readable in both light and dark mode. See Fonts, sizes and colors.

Can I schedule a post?

Not yet. Save it as a draft and publish it when you are ready.

Can people see what I changed when I edit a post?

They see an "edited" note, but not the previous version.

Feed and discovery

Why doesn't the feed scroll forever?

ArabDev uses numbered pages of 20 posts on purpose. See Pages instead of infinite scroll.

Why is this post at the top of my feed?

In the For you tab, recent posts rank higher when they come from people you follow or interact with, match your interests, or were liked or reposted by people you follow, and when they are starting a discussion. See For you. Use the Latest tab for pure time order.

Can I stop appearing in suggestions?

Yes: turn off Show me in search and suggestions in Settings → Privacy.

If I report a post, will the author know it was me?

No. The author is told that the post was reported and why, never by whom. Only the moderators see who sent a report. See Reporting a post.

Privacy and ads

Does ArabDev sell my data?

No. ArabDev does not sell, rent or trade personal information, and ads are never chosen using your personal data. See the Privacy Policy.

Can people see which posts I liked?

The author of a post is notified when you like it. There is no public list of your likes.

Are bookmarks private?

Yes, completely.

How do I block someone?

Open the ⋯ menu on their profile or on one of their posts and choose Block. They aren't told. To undo it, use the same menu or Settings → Privacy → Blocked accounts. See Blocking.

How many ads will I see?

Up to three in a page of the feed (after the 3rd, 9th and 15th post), one in the side column on large screens, one under a post, and one or two on the homepage. Google may add a few automatic placements, which it marks as ads. See Ads on ArabDev.

Other

Is there private messaging?

Not yet.

Is there a mobile app?

ArabDev is a responsive website designed for phones as well as computers, and you can add it to your home screen: in your phone’s browser menu choose Add to Home screen (or Install app). It then opens full screen with its own icon. There is no separate app-store app.

Why does ArabDev email me a code?

To make sure it is really you. Signing in, creating an account and changing your email or password are confirmed with a six-digit code, so a stolen password alone cannot open your account. See Confirmation codes. If you turned on an authenticator app, signing in asks for a code from the app instead of an email.

Can I contribute to ArabDev?

Yes. See Contributing and license, or write to hi@arabdev.site.

How do I contact ArabDev?

For help, bugs and reports write to support@arabdev.site; for sponsorship, contributions and other questions write to hi@arabdev.site. See Contact and support.

Common problems and how to fix them. Messages are quoted as they appear in the English interface.

Signing in

Message or symptomWhat to do
"Email or password is incorrect."Check the email for typos and make sure Caps Lock is off. If you are unsure of your password, use Forgot password?
"Too many attempts. Wait a moment and try again."You reached a rate limit. Wait a minute and try again.
"Your session has expired. Please sign in again."Your sign-in ended: you were signed out elsewhere, you changed your password, or "Keep me signed in" was off and the session ran out. Sign in again.
You keep being signed out when closing the browserCheck "Keep me signed in" when signing in. Browsers set to delete cookies on exit also sign you out.
The reset link says it is invalid or expiredLinks last 30 minutes and work only once. Request a new one.
The six-digit code does not arriveCheck your spam folder and that the address shown is yours. Wait a minute, then choose Send another code. The email comes from noreply@arabdev.site.
"That code is not right."Check the newest email: each new code replaces the previous one. After five wrong tries, start again.
"This code has expired."Codes last 10 minutes. Ask for a new one.
"Please complete the security check and try again."Reload the page and try again. If it keeps happening, allow challenges.cloudflare.com in your blocker or privacy extension. See The security check.
"That code isn't right. Check the app and try again."Make sure your phone sets its clock automatically: the codes depend on it. Type the code showing now, not one about to change. If you lost the phone, use a recovery code.
"This password has turned up in a data breach…"The password is on a public list of leaked passwords, so attackers already try it. Choose a different one. See Leaked passwords.

Creating an account

MessageMeaning
"This username is already taken."Someone else has it. Try adding numbers or an underscore.
"This username is reserved."The name is used by the site itself. Choose another.
"3–20 characters: English letters, numbers and _, starting with a letter."The username breaks one of the username rules.
"An account with this email already exists."Sign in instead, or reset the password for that account.
"Mix letters and numbers so it's harder to guess."Add at least one letter and one number, and avoid repeating the same few characters.
"Passwords don't match."The two password fields are different.

Uploading images

MessageWhat to do
"Images must be 5 MB or smaller."Export the image at a smaller size or lower quality.
"Use a JPEG, PNG, WebP or GIF image."Convert the file, for example from HEIC, BMP or TIFF, to one of these.
"This file isn't a valid image."The file is damaged or is not really an image. Open and re-save it in an image editor.
"This image is too small."Profile pictures need at least 96×96 pixels, post images at least 64 pixels on the shorter side.
"This image's dimensions are too large."Resize it: profile pictures up to 8000 pixels per side, post images up to 10,000.

Posting

  • "Write something before publishing." The body is empty. A title alone is not enough.
  • "Enter a valid link starting with http:// or https://." Fix the attached link or clear the field.
  • "You can't repost your own post." Reposting is for sharing other people's posts.
  • My formatting changed after publishing. Formatting outside the editor's options is removed. See What happens to your post when you publish.
  • "We couldn't confirm you're not a robot." The background check couldn't run. Reload the page; if it keeps happening, allow challenges.cloudflare.com in your blocker. See The security check.
  • "New accounts can add up to 2 links during their first day." Remove a link or wait until your account is a day old. See New accounts and spam.
  • "You already posted this." The same text was published from your account within the last day.

Display

  • The layout is mirrored the wrong way. The direction follows the language. Switch the language in the account menu or Settings → Appearance.
  • Dark mode does not follow my device. Set the theme to System.
  • "Can't reach the server." Check your internet connection and reload the page.

ArabDev has two email addresses, one for getting help and one for everything else. Write in Arabic or English; a person reads every message. The same information is on the app's own Contact page, and About ArabDev explains who runs the platform.

Which address to use

AddressWrite to it about
support@arabdev.siteProblems with your account, signing in or password resets; bugs and anything that does not work as described in this wiki; reporting posts, comments or profiles that break the community guidelines; security problems; privacy requests such as a copy of your data.
hi@arabdev.siteSponsoring ArabDev or advertising on it; contributing code, translations or documentation; partnerships and commitments with communities, companies and universities; press; and general questions about ArabDev.
Not sure?

If something is broken or blocking you, use support. For anything you would like to discuss, say hi.

Getting support

To help us answer quickly:

  • Write from the email address of your ArabDev account, and include your username.
  • Describe what you were doing, what you expected and what happened instead.
  • Quote any message exactly as it appeared, or attach a screenshot.
  • Say which browser and device you use, and whether ArabDev was in Arabic or English.
  • Never send your password. Nobody from ArabDev will ever ask for it.

Before writing, the Troubleshooting and Frequently asked questions articles may already have the answer.

Reporting content

To report a post, use Report post in its ⋯ menu (see Reporting a post). To report a comment or a profile, or anything urgent, send its link to support@arabdev.site with a short explanation. Reports are handled confidentially; the person reported is never told who reported them.

Reporting a security problem

Send security problems privately to support@arabdev.site with the subject "Security", and do not publish them until they are fixed. Include the steps to reproduce the problem and what an attacker could do with it. Please do not access other people's data or disrupt the service while testing.

Privacy requests

To get a copy of your data, correct it, or ask a question about how it is used, write to support@arabdev.site from your account's email address. Requests are acknowledged within 7 days and answered within 30. See the Privacy Policy for your rights.

Sponsors, contributors and partners

Write to hi@arabdev.site if you would like to:

  • Sponsor ArabDev or place an ad. Ads follow strict rules; see Ads on ArabDev.
  • Contribute code, fix a translation or improve this wiki. See Contributing and license.
  • Bring your community, company or university to ArabDev, or make a longer-term commitment to support it.
  • Ask anything else about ArabDev.

ArabDev addresses

AddressWhat it is
arabdev.siteThe homepage: what ArabDev is, and the latest posts from the community. Open to everyone.
arabdev.site/dashboardThe ArabDev app. The dashboard is your home feed once you are signed in.
arabdev.site/aboutAbout ArabDev: why it exists, who runs it, how it is paid for and how it is moderated.
arabdev.site/contactThe two contact addresses and what to include when you write.
wiki.arabdev.siteThis wiki.
privacy.arabdev.siteThe Privacy Policy.
patch.arabdev.sitePatch notes: what changed in each release.

ArabDev will only ever email you from an @arabdev.site address, and never asks for your password by email. Treat any other message claiming to be from ArabDev as suspicious.

Authenticator app
A phone app, such as Google Authenticator, that makes a new six-digit sign-in code every 30 seconds. Optional; see Authenticator app.
Bookmark
A private save of a post, listed on your Bookmarks page and the Saved tab of your profile.
Block
Cutting off an account: neither of you can follow, comment on, reply to or repost the other, and you stop seeing their posts. See Blocking.
Display name
The name shown on your profile and posts. Any script, up to 50 characters.
Draft
An unpublished post that only you can see.
Feed
A list of posts. The home feed has three tabs: For you, Following and Latest.
Follow
Subscribing to someone's posts and reposts in your Following feed.
Confirmation code
A six-digit code emailed to confirm a sign-in, a new account, or a change of email or password. Valid for 10 minutes, once.
House ad
An ad in which ArabDev promotes its own features, shown where Google has no ad and no sponsor ad is booked.
Security check
Cloudflare Turnstile, which checks that a real browser is behind sign-ins, sign-ups, posts, comments and everything else you change. Usually invisible.
Interest
One of 25 topics you can pick to shape your feed and suggestions.
Moderator
A member of the ArabDev team who reviews reports and decides whether to keep a post, remove it, or restrict or suspend its author.
Mention
Writing @username in a post or comment, which notifies that person.
Onboarding
The four-step setup window shown on your first visit.
Recovery code
One of ten single-use codes that sign you in in place of the authenticator app's code, if you lose your phone.
Report
Flagging a post that breaks the community guidelines, with a reason, so the moderators review it.
Repost
Sharing someone else's post with your followers without changing it.
Restricted account
An account the moderators stopped from posting, commenting and reposting until a set date. It can still read, like and save.
RSS feed
A list of the newest posts that feed readers can follow, for the whole site, a tag or a person. See RSS feeds.
RTL / LTR
Right-to-left (Arabic) and left-to-right (English) text direction.
Sponsored
The label on ads from sponsors and on ArabDev's own notices. Google ads are labelled Advertisement.
Tag
A keyword describing a post, such as #python. Up to 5 per post.
Trending
Posts from the last 7 days ranked by how quickly they are gathering likes, comments and reposts.
Username
Your unique handle, used in your profile address and in mentions.

ArabDev is a single-page web application backed by a REST API. This article describes how the pieces fit together.

Technology

LayerTechnology
User interfaceReact 19, TypeScript, Material UI 9, Emotion (with a right-to-left style plugin)
Routing and dataReact Router 8, TanStack Query 5, Axios
EditorTipTap 3 (ProseMirror)
Languagesi18next with ar.json and en.json
BuildVite 8
APIPython, FastAPI, Pydantic 2
DatabaseSQLAlchemy 2 with Alembic migrations: SQLite for development and single-server hosting, PostgreSQL (Neon) on Vercel
SecurityArgon2id password hashing, JWT access tokens, rotating refresh tokens, emailed six-digit codes, authenticator apps (TOTP), a leaked-password check, Cloudflare Turnstile, security headers
Content safetynh3 on the server, DOMPurify in the browser
ImagesPillow, re-encoding to WebP
RedisShared rate limits and caching (Upstash in production; optional elsewhere)
Code checksRuff (lint and format) and pip-audit for Python; oxlint, Prettier and npm audit for the frontend
Testspytest (111 tests, run against SQLite and PostgreSQL), run by continuous integration on every pull request

Repository layout

Arabdev/
├── backend/          FastAPI application, Alembic migrations, tests
├── frontend/         React application
├── wiki/             This wiki (static site)
├── privacy/          Privacy Policy (static site)
├── patch-notes/      Patch notes (static site)
├── api/index.py      Entry point that serves the API on Vercel
├── vercel.json       Build, routing and the scheduled clean-up
├── requirements.txt  Python packages for the Vercel function
├── LICENSE           GNU GPL v3
├── CONTRIBUTING.md   How to contribute, and the checks to run
├── CODE_OF_CONDUCT.md
├── .github/          CI, issue and pull request templates
├── docker-compose.yml
└── README.md

Backend structure

  • app/main.py creates the application: middleware, error handlers, the API router and the media file mount.
  • app/core/: settings, database engine, security helpers, dependencies, error types, rate limiting and caching.
  • app/models/: SQLAlchemy models for the 21 tables.
  • app/schemas/: Pydantic models for requests and responses.
  • app/api/v1/: route modules grouped by topic.
  • app/api/pages.py and app/services/page_service.py: write a post's, profile's, tag's or Explore's own title, description and text into the app shell, so crawlers and link previews that do not run JavaScript can read them. The text is built from plain text and escaped; the app replaces it when it starts.
  • app/api/feeds.py: the RSS feeds.
  • app/repositories/: query builders.
  • app/services/: business rules such as permissions, notifications, feeds and media processing.
  • app/utils/: the HTML sanitizer, validators, pagination and text helpers.

Frontend structure

  • src/api/: the HTTP client, endpoint functions, query keys and cache update helpers.
  • src/features/: one folder per feature (auth, posts, editor, comments, settings, moderation, ads, users and so on) with its components and hooks. Pages only put them together for a route.
  • src/components/: shared pieces such as Logo, EmptyState, LoadingState, Pagination and Notifier.
  • src/layouts/: AppLayout, Navbar, Sidebar, RightSidebar and MobileNavigation.
  • src/pages/: route components, loaded on demand.
  • scripts/prerender.mjs: runs after the build and writes the homepage, About and Contact text into their HTML, taken from the same translation files the app uses, so those pages can be read without JavaScript.
  • src/theme/: colors, typography, tokens and the Material UI theme.

Database tables

TableHolds
usersAccounts: username, email, password hash, flags, token version, authenticator app key (encrypted)
profilesDisplay name, bio, location, website, avatar
user_settingsTheme, language, privacy and notification preferences
interests, user_interestsThe 25 topics and who picked them
posts, draftsPublished posts (with counters) and unpublished drafts
tags, post_tagsTags, their link to interests, and which posts use them
commentsComments and replies
likes, bookmarks, reposts, followsOne row per person and target
notificationsWho did what to whom, and whether it was read
mediaUploaded images: owner, kind, storage key, size and dimensions
adsAds with placement, language, schedule and total counts
refresh_tokens, password_reset_tokensHashed session and reset tokens with expiry
verification_codesHashed six-digit codes, what each confirms, attempts and expiry
reportsReports on posts: reason, details, who reported, a copy of the post's title and opening, and the moderators' decision
blocksWho blocked whom, and when
recovery_codesHashed single-use recovery codes for the authenticator app

Foreign keys, usernames, emails, creation dates, tags and follow relationships are indexed. SQLite runs in WAL mode with foreign keys enforced.

Checks

Continuous integration runs these on every pull request. Run them before you push:

cd backend
pytest
ruff check .
ruff format --check .
pip-audit

cd frontend
npm run lint
npm run format:check
npm run build

CONTRIBUTING.md explains how the code is organised and what a pull request needs.

Running locally

# Backend
cd backend
python -m venv .venv
.venv/Scripts/activate        # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env          # set SECRET_KEY
alembic upgrade head          # creates backend/arabdev.db
python -m app.cli seed --demo # optional demo content
uvicorn app.main:app --reload --port 8000

# Frontend (second terminal)
cd frontend
npm install
npm run dev                   # http://localhost:5173

The development server forwards /api and /media to the API on port 8000 and serves this wiki, the privacy policy and the patch notes at /wiki/, /privacy/ and /patch-notes/.

Configuration

VariableDefaultPurpose
SECRET_KEYdevelopment valueSigns access tokens. Required in production.
DATABASE_URLbackend/arabdev.dbSQLite file location, or a PostgreSQL URL such as the one Neon adds to a Vercel project.
ENVIRONMENTdevelopmentproduction refuses to start without a real secret key.
REDIS_URLunsetShares rate limits and caches between processes.
CORS_ORIGINSlocal dev addressesComma-separated list of allowed browser origins.
FRONTEND_URLhttp://localhost:5173Base address used in password reset links. In production: https://arabdev.site.
COOKIE_SECUREfalseSet to true when serving over HTTPS.
MEDIA_ROOTbackend/mediaWhere uploaded images are stored.
STORAGE_BACKENDlocaldatabase keeps images in the database instead of on disk (the default on Vercel).
CRON_SECRETunsetBearer token the scheduled clean-up endpoint expects.
ACCESS_TOKEN_EXPIRE_MINUTES15Access token lifetime.
REFRESH_TOKEN_EXPIRE_DAYS30"Keep me signed in" lifetime.
RATE_LIMIT_ENABLEDtrueTurns rate limiting on or off.
TRUSTED_PROXY_HOPS1How many proxies in front of the API append to X-Forwarded-For. 1 fits Vercel and the Docker nginx; add one per extra proxy, such as Cloudflare’s orange-cloud proxy.
SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, SMTP_STARTTLS or SMTP_SSLunset, 587Outgoing mail. Without a host, emails are written to the log instead.
MAIL_FROMArabDev <noreply@arabdev.site>Sender of every email. Replies go to the support address.
EMAIL_CODES_ENABLEDfollows the mail setupEmailed six-digit codes. Unset: on in development, and in production only once SMTP is configured. false switches them off instantly if mail breaks.
TURNSTILE_SITE_KEY, TURNSTILE_SECRET_KEYunsetCloudflare Turnstile. The check runs only when both are set. Cloudflare’s test keys work on localhost.
SPA_SHELL_URL, SPA_SHELL_PATHFRONTEND_URL/app.htmlWhere the API reads the built app shell that it writes public pages into: a URL to fetch, or a file path. Docker Compose sets the URL to the frontend container.
ADMIN_USERNAMESunsetComma-separated usernames that act as moderators, in addition to accounts with the administrator flag (python -m app.cli make-admin).
MODERATION_EMAILthe support addressWhere new reports are emailed.
REPORT_AUTO_HIDE_THRESHOLD3How many different people must report a post before it is hidden until reviewed.
REPORT_RETENTION_DAYS365How long decided reports are kept before the scheduled clean-up deletes them.
PWNED_PASSWORDS_ENABLEDtrueChecks new passwords against Have I Been Pwned's list of leaked passwords. Turn it off on a server without internet access.
INDEXNOW_ENABLEDon in productionTells Bing, Yandex and the other IndexNow engines when a post is published, edited or deleted. The key file is served at /<key>.txt, and the key is derived from SECRET_KEY.

Google AdSense unit ids are not settings: they live in frontend/src/site.ts. Change them there when you run your own copy.

Management commands

  • python -m app.cli seed adds the 25 interests and the house ads. Safe to run repeatedly.
  • python -m app.cli seed --demo also adds ten fictional developers and 26 posts. For development only.
  • python -m app.cli make-admin USERNAME gives a user administrator rights.
  • python -m app.cli purge-tokens deletes ended sign-in sessions and old password reset links. The API also does this when it starts, then every six hours on a server, or once a day on Vercel through the scheduled job in vercel.json.
  • python -m app.cli indexnow sends every address in the sitemap to the IndexNow engines at once, for a new site or after a long break. Posts are sent on their own as they are published.
  • alembic upgrade head applies database migrations.
  • pytest runs the test suite on a fresh in-memory database.

Docker

docker compose up --build starts Redis, the API (with the SQLite file on a data volume and uploads on a media volume) and nginx serving the app on port 8080. The API container applies migrations and seeds reference data when it starts.

Deploying

  • Vercel (how arabdev.site runs): one project built from the repository root. vercel.json builds the app into frontend/dist and serves the API from api/index.py, so the app and the API share one address and no cross-site settings are needed.
  • That project needs a PostgreSQL database (add Neon under Storage, which sets DATABASE_URL), a Redis store for rate limits (add Upstash under Storage with the prefix REDIS, which sets REDIS_URL), plus SECRET_KEY, CRON_SECRET, the SMTP settings and the two Turnstile keys. Security headers for the app are set in vercel.json. VERCEL=1 is set for you and switches on production mode, secure cookies and database image storage.
  • The wiki, privacy and patch-notes folders are complete static sites with no build step, deployed as their own projects to wiki.arabdev.site, privacy.arabdev.site and patch.arabdev.site.
  • One server instead (VPS, Docker): keep SQLite and store images on disk. The API then needs a persistent disk for the database file and uploads, and runs as a single process. Serve the app build (frontend/dist, including LICENSE.txt) as a static site; set VITE_API_ORIGIN when the API is on another address.
  • Serve everything over HTTPS and set COOKIE_SECURE=true.

Backups

With SQLite, back up arabdev.db and the media folder; while the API is running, use sqlite3 arabdev.db ".backup backup.db" for a consistent copy. With PostgreSQL, use your provider's backups (Neon keeps a restore window) or pg_dump; images are inside the database, so one dump covers everything.

Email

ArabDev sends mail over SMTP (backend/app/services/email_service.py): confirmation codes, security alerts and password reset links, each in the reader’s language with a plain-text copy. Any SMTP service works; arabdev.site sends through Google’s mail service as noreply@arabdev.site. Without SMTP_HOST, messages are written to the server log, which is how you read codes when developing locally. In production, codes stay switched off until SMTP is configured, so a missing mail provider cannot lock anyone out; after connecting one, sign in once to check that codes arrive.

Everything the app does goes through a versioned REST API under /api/v1. Interactive documentation is served at /api/docs (Swagger UI) and /api/redoc, and the machine-readable description at /api/v1/openapi.json.

Authentication

  • Send the access token as Authorization: Bearer <token>.
  • POST /auth/login and POST /auth/register return {status, tokens, challenge}. With status: "authenticated", tokens holds {access_token, token_type, expires_in, user} and the refresh cookie is set. With status: "verification_required", challenge holds {challenge_id, email, purpose, expires_in, resend_in}: send {challenge_id, code} to POST /auth/verify to receive the tokens, or {challenge_id} to POST /auth/resend for another code.
  • Sign-in, sign-up, password reset requests, email and password changes, new posts and new comments need a Cloudflare Turnstile token in the X-Turnstile-Token header when Turnstile is configured. GET /auth/config returns the public site key and whether codes are on.
  • Changing email (POST /users/me/email) and password (POST /users/me/password) answer with {status, challenge} the same way and are finished at /verify under the same path.
  • POST /auth/refresh and POST /auth/logout use the cookie and require an X-ArabDev-Client header, which protects them from cross-site requests.

Pagination

Every list endpoint accepts page (from 1) and limit (1–20, default 20) and returns:

{ "items": [...], "page": 1, "limit": 20, "total": 100, "pages": 5 }

Errors

Errors always have a readable detail and a stable code. Validation errors add an errors list; errors about one field add field.

{ "detail": "Username is already taken", "code": "username_taken", "field": "username" }

Common codes include invalid_credentials, token_invalid, session_expired, rate_limited, username_taken, email_taken, password_too_weak, post_empty, not_post_author, cannot_repost_own, cannot_follow_self, follow_lists_private, file_too_large, file_not_image, media_not_owned, code_invalid, code_expired, code_used, code_attempts_exhausted, code_resend_too_soon, turnstile_missing, turnstile_expired, turnstile_failed, human_check_required, too_many_links, risky_link, duplicate_post, duplicate_comment and email_disposable.

Endpoints

GroupEndpoints
AuthenticationGET /auth/config, POST /auth/register, POST /auth/login, POST /auth/verify, POST /auth/resend, POST /auth/refresh, POST /auth/logout, GET /auth/availability, POST /auth/forgot-password, POST /auth/reset-password
Your accountGET /users/me, PATCH /users/me/profile, PATCH /users/me/username, POST /users/me/email, POST /users/me/email/verify, POST /users/me/password, POST /users/me/password/verify, GET /users/me/sessions, DELETE /users/me/sessions/{id}, POST /users/me/sessions/revoke-others, GET /users/me/export, PUT /users/me/interests, GET|PATCH /users/me/settings, POST /users/me/onboarding/complete, POST|DELETE /users/me/avatar, DELETE /users/me, GET /users/me/bookmarks
UsersGET /users/recommended, GET /users/{username}, GET /users/{username}/posts, GET /users/{username}/replies, GET /users/{username}/followers, GET /users/{username}/following, POST|DELETE /users/{id}/follow
PostsGET /posts?tab=for_you|following|latest&tag=, GET /posts/trending, GET /posts/{id}, POST /posts, PUT /posts/{id}, DELETE /posts/{id}
InteractionsPOST|DELETE /posts/{id}/like, POST|DELETE /posts/{id}/bookmark, POST|DELETE /posts/{id}/repost
CommentsGET /posts/{id}/comments, POST /posts/{id}/comments, DELETE /comments/{id}
DraftsGET|POST /drafts, GET|PUT|DELETE /drafts/{id}
Search, tags, interestsGET /search?q=&type=all|posts|users|tags, GET /tags/popular, GET /tags/{slug}, GET /interests
NotificationsGET /notifications, GET /notifications/unread-count, POST /notifications/read-all, POST /notifications/{id}/read
MediaPOST /media, DELETE /media/{id}
AdsGET /ads, POST /ads/{id}/click; for administrators, GET|POST /ads/manage and PUT|DELETE /ads/manage/{id}
ModerationPOST /posts/{id}/report; for moderators, GET /admin/summary, GET /admin/reports?status=open|resolved, GET /admin/reports/{id}, POST /admin/reports/{id}/decision, GET /admin/restricted, POST /admin/users/{id}/lift
HealthGET /health
Search enginesGET|HEAD /sitemap.xml and the IndexNow key file GET /<key>.txt (at the site root, outside /api)
Readable pagesGET|HEAD /posts/{id}, /u/{username}, /tags/{slug} and /explore at the site root return the app's HTML with that page's title, description and text already in it
Two-step sign-inPOST /users/me/two-factor/setup, POST /users/me/two-factor/enable, POST /users/me/two-factor/disable, POST /users/me/two-factor/recovery-codes. While it is on, POST /auth/login answers with a login_2fa challenge, which POST /auth/verify completes with the app's code or a recovery code.
BlockingGET /users/me/blocked, POST|DELETE /users/{id}/block
RSSGET|HEAD /rss.xml, /u/{username}/rss.xml and /tags/{slug}/rss.xml at the site root
Human checkPOST /users/me/human-check trades a Turnstile token for a 30-minute pass. While Turnstile is configured, send the pass in the X-ArabDev-Human header with likes, bookmarks, reposts, follows, blocks, reports, uploads, drafts, post edits and deletions, comment deletions and profile changes; without it they answer 403 human_check_required.

Example: publishing a post

POST /api/v1/posts
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "title": "Pagination that doesn't lie",
  "content_html": "<p>Always return total and pages.</p>",
  "link_url": "https://example.org/article",
  "image_media_id": null,
  "tags": ["fastapi", "databases"]
}

The response is the created post, with its sanitized HTML, tags, author, counters and your like, save and repost state.

The license

ArabDev is free software released under the GNU General Public License, version 3 or later (GPL-3.0-or-later). In short:

  • You may use, study, share and change ArabDev.
  • If you distribute ArabDev or a modified version, you must share its source code under the same license and keep the copyright and license notices.
  • ArabDev comes without any warranty.

This summary is for convenience. The license text itself is what applies.

Third-party components

ArabDev uses open-source libraries under their own licenses, listed in frontend/package.json and backend/pyproject.toml. The Alexandria, Tajawal and Anton fonts are used under the SIL Open Font License; each font folder under frontend/public/fonts includes its license.

To talk about contributing, sponsoring or partnering with ArabDev, write to hi@arabdev.site.

Contributing code

  • Read CONTRIBUTING.md first, and open an issue before starting anything bigger than a small fix. The code of conduct applies everywhere around the project.
  • Keep the backend layering: routes call services, services use repositories.
  • Return errors with a stable code and add its translation to both language files.
  • Never put interface text directly in components: add keys to src/i18n/ar.json and src/i18n/en.json.
  • Use theme values, not hard-coded colors, and physical CSS properties that the RTL plugin can mirror (or logical ones where content direction matters).
  • Add or update tests for backend changes, and run the checks before opening a pull request.
  • Update this wiki and the patch notes when behaviour changes.

Improving translations

Both languages live in two JSON files with identical keys. Arabic plural forms (zero, one, two, few, many, other) are supported and should be filled in for any text that contains a number.