Sections

Manage the custom sections on your homepage from the terminal: the section blocks and the items inside them.

Sections are the blocks below your profile (Projects, Experience, a gallery, and so on). Each section has a type and a list of items.

floggy sections list
floggy sections list --json
floggy sections create --title "Talks" --type list
floggy sections edit <id> --title "Speaking" --visible true --order 0
floggy sections delete <id>
floggy sections reorder <id1> <id2> <id3> ...

sections edit flags: --title, --type, --visible true|false, --order <n>. All optional.

sections reorder needs the FULL ordered id list. A subset reindexes only those ids and can collide. List first, then reorder the complete set.

Items

Each section holds items. Item commands take the section id first, then the item id where relevant.

floggy sections item-add <sectionId> --title "Rustconf 2025" --date 2025-09-01 --url https://rustconf.com
floggy sections item-edit <sectionId> <itemId> --title "RustConf 2025"
floggy sections item-delete <sectionId> <itemId>
floggy sections item-reorder <sectionId> <itemId1> <itemId2> ...

Item flags: --title, --description, --image, --url, --date, --end-date, --company, --location, --order. Use the ones that fit the section type (dates and company/location suit work-experience and timeline; image suits gallery and cards).

item-reorder needs the complete ordered item id list for that section, same rule as section reorder.

Gotcha: item URLs are stored as given

A section item's --url is stored EXACTLY as you pass it, with no https:// auto-prefix. This is different from portfolio project urls, which are normalized. Pass a full URL for section items:

floggy sections item-add <sectionId> --title "My site" --url https://example.com

Passing a bare example.com stores example.com verbatim, which will not resolve as a link.

Scopes

Command	Scope
`sections list`	`profile:read`
`sections create/edit/delete/reorder`, all `item-*`	`profile:write`