Links, events, and files

Keep supporting material attached to the project without losing its identity or safe navigation rules.

On this page

Purpose and usage

Keep supporting material attached to the project without losing its identity or safe navigation rules.

Use for project support materials; place the primary next action in task context instead.

Anatomy

Anatomy
Part	Contract
Link card	Category, title, description, hostname and separate edit action.
Event	Date/time, title and contextual detail.
File/folder	Name, kind, hierarchy and relevant action.

Variants and configuration

Variants and configuration
Configuration	Behavior
Links	color, links, onEditLink.
Events	Project event records rendered in their calendar context.
Files	Dedicated API and storage-dependent workspace.

State coverage

State coverage
State	Implemented behavior
Valid URL	External destination is normalized before activation.
Invalid URL	Invalid destination is not rendered as a safe outbound link.
Editing	Resource-specific modal.
Upload	File reservation, transfer and completion boundaries.

Interaction and responsive behavior

Use the same project palette for its resource cards.
Keep whole-card navigation separate from edit controls.
Do not create a working upload demo that can contact real storage.

Accessibility contract

Name external resource links with their title.
Label edit and navigation controls separately.
Uploads need independent progress, error, and keyboard verification.

Known gaps and readiness

File upload states are inventoried from source but not presented as verified applied captures in this pilot. B2 transfer and backend resource mutations are intentionally excluded.

Composition example

<ProjectLinksGrid color={project.color}
  links={project.links} onEditLink={setEditingLink} />

Source references

Source references
File	Responsibility
app/components/project-links-grid.tsx	External resource cards
app/components/project-events-calendar.tsx	Date-grouped project events
app/components/project-files-workspace.tsx	Folder/file management
app/components/project-file-utils.ts	File type and name helpers