Theme Paperdesk
Package docs status
Section titled “Package docs status”This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.
| Field | Value |
|---|---|
| Composer package | capell-app/theme-paperdesk |
| Package slug | theme-paperdesk |
| Product group | Capell Themes |
| Tier | premium |
| Bundle | themes |
| Runtime contexts | frontend |
| Capell version | ^1.0 |
| Catalogue role | extension |
| Release channel | Labs |
| Source repository | capell-app/packages |
| Source path | packages/theme-paperdesk |
| Docs source | packages/theme-paperdesk/docs |
| Manifest | capell.json |
Paperdesk is a premium Capell child theme for stationers, printmakers, bookbinders, ceramicists, keepsake makers, and other material-led studios.
Its signature surface is a deterministic public desk of polaroids, tickets, swatches, folded letters, and taped notes. Visitors can follow ordinary links, use accessible flip controls, tidy the desk, or switch to its canonical list. Dragging is decorative and never gates content or conversion.
- Status: Available
What This Plugin Adds
Section titled “What This Plugin Adds”- Three Theme Studio presets: Letterpress, Studio Linen, and Midnight Atelier.
- Ten package-owned Layout Builder widgets and three declared section variants.
- An active-theme-only ES module for flip, tidy, and pointer-drag enhancements.
- Seven original Mabel & Quill demo surfaces with canonical internal links.
- Safe fallbacks for bookings, forms, newsletters, events, search, slideshows, blog, and comments.
Why It Matters
Section titled “Why It Matters”For developers: Paperdesk keeps its desk composition and progressive enhancement inside package-owned theme views while ordinary links remain the server-rendered source of truth.
For teams: Material-led studios get a tactile presentation without making dragging, animation, or JavaScript a requirement for browsing or conversion.
Screens And Workflow
Section titled “Screens And Workflow”Responsive surfaces and release capture requirements are defined in the screenshot contract. Only supported runner output is release evidence.
Quick Start
Section titled “Quick Start”- Install with
composer require capell-app/theme-paperdesk. - Select Paperdesk through Capell’s theme-management surface.
- In a disposable environment, run
php artisan capell:theme-paperdesk-demo.
Paperdesk requires Foundation Theme, Frontend, and Layout Builder. Public Blade is query-free and contains no frontend-authoring state, signed editor links, model IDs, or package metadata.
Technical Shape
Section titled “Technical Shape”The theme registers presets, Layout Builder widgets, and an active-theme frontend module through shared Capell registries.
Data Model
Section titled “Data Model”Paperdesk has no package-owned schema. It consumes Core site and page records through prepared render data.
Install Impact
Section titled “Install Impact”- Required packages: Foundation Theme, Frontend, and Layout Builder.
- Database changes: none declared.
- Public routes: none declared.
Common Pitfalls
Section titled “Common Pitfalls”- Keep dragging decorative; ordinary links and controls must remain usable without JavaScript.
- Keep public output free of editor state and package metadata.
Troubleshooting
Section titled “Troubleshooting”If the theme is not visible, refresh package autoload and host theme/config caches. If an integration is absent, verify its optional package and named public route.
Development
Section titled “Development”Build with npm run --prefix packages/theme-paperdesk build, then run vendor/bin/pest packages/theme-paperdesk/tests --configuration=phpunit.xml.
See the package docs, operator overview, and screenshot contract.