What This Screen Does

This is your blog overview page. Think of it like a bulletin board where all your published articles are pinned up for you to browse. You can see every blog post in the system, sort them by date, page through them, and — if you are an administrator — create new posts. From here you can also view, edit, or delete individual articles.

How to Get There

Open the dashboard.
In the left-hand menu, click Blog.
You are now on the Blog Post List screen.

Step-by-Step Guide

1. Browse Articles

When the page loads, it automatically fetches the first 10 articles, sorted from newest to oldest.
Articles are displayed in a grid — two columns on desktop, one column on mobile.
Each article card shows a summary of the post. You can interact with individual cards to view, edit, or delete them (see steps below).
If there are more than 10 articles, a pagination bar appears at the bottom of the list.

2. Sort Articles

Near the top-right of the page you will see a Sort By button.
Click it to open a small menu with two options:

Option	What It Does
Latest	Shows the newest articles first (default).
Oldest	Shows the oldest articles first.

Pick the option you prefer. The list will reload from page 1 with the new sort order.

3. Page Through Results

If you have more than 10 articles, numbered page buttons appear at the bottom of the list.
Click a page number to jump to that page.
The system fetches the matching set of articles from the server each time you change pages.

4. View an Article

Click the view action on an article card.
You will be taken to the full article detail page at /blog/:id.

5. Edit an Article

Click the edit action on an article card.
You will be taken to the article editing screen at /blog/:id/edit.
Note: Editing options are only available to administrators (see Permissions below).

6. Delete an Article

Click the delete action on an article card.
The system will delete the article immediately.
A green “Deleted!” notification will appear.
The list will refresh automatically so the deleted article disappears.
Warning: Deletion is permanent. There is no undo.

7. Create a New Post (Admin Only)

If you are an administrator, a + New Post button appears in the top-right corner next to the breadcrumbs.
Click it to go to the new post creation screen at /blog/new.
If you are not an admin, this button will not be visible.

Permissions

Role	Can View List	Can Create Post	Can Edit / Delete
Admin	Yes	Yes	Yes
Non-Admin	Yes	No	No

The + New Post button only appears for users with an admin role.
Edit and delete actions on article cards are handled at the card level, but the underlying API enforces permissions.

What Happens Behind the Scenes

Loading the List

Page loads (or you change page / sort order)
        |
        v
API call: getArticles({ pageNumber, pageSize: 10, sortBy: ['createdDate'], direction })
        |
        v
Server returns a list of articles and total count
        |
        v
Articles are displayed in a grid
        |
        v
If total count > 10, pagination controls appear

Deleting an Article

You click "Delete" on an article card
        |
        v
API call: ArticleService.delete({ id })
        |
        v
Article is removed from the server
        |
        v
"Deleted!" notification appears
        |
        v
List refreshes to reflect the change

Troubleshooting

“The page is loading but no articles appear”

If you see skeleton placeholders (grey shimmering boxes) that never go away, your connection to the server may have been interrupted.
Try refreshing the page.
If the list loads but is genuinely empty, no articles have been created yet. Ask an administrator to create the first post.

“I do not see the + New Post button”

This button is only visible to administrators.
If you believe you should have admin access, contact your system administrator to check your role.

“I clicked Delete and the article is gone — can I undo it?”

No. Deletion is permanent and immediate. There is no recycle bin or undo feature.
If you deleted an article by mistake, you will need to recreate it from scratch.
Consider copying or backing up important articles before deleting.

“The sort order does not seem to change”

Make sure you actually selected a different option from the Sort By menu. The current selection is highlighted.
Changing the sort resets you to page 1. If you were on a later page, it may look like the same articles — check the sort order by comparing the dates on the article cards.

“Pagination is not showing even though I know there are more articles”

Pagination only appears when there are more than 10 articles in total.
If you have exactly 10 or fewer, all articles fit on one page and no pagination is needed.

“I clicked a page number but the same articles are showing”

The system fetches fresh data from the server each time you change pages. If the articles look the same, it may be that different pages contain similar-looking content.
Check the article titles and dates carefully — they should differ from page to page.

“I get an error when trying to delete an article”

You may not have the required permissions. Only administrators can delete articles.
If you are an admin and still see an error, the server may be temporarily unavailable. Wait a moment and try again.
If the problem persists, contact your system administrator with the error message.

“The page feels slow to load”

Each page change triggers a network request to fetch articles. If your internet connection is slow, this may take a few seconds.
The loading skeleton (grey placeholder boxes) will show while articles are being fetched. Wait for them to be replaced with real content.
If it stays stuck on loading, try refreshing the page.

Blog Post List