DevelopersDeveloper FAQ

Developer FAQ

Technical FAQ for developers integrating with PWFabric. For end-user/product questions, see the main FAQ.

Getting started

What is PWFabric?

PWFabric is the surface operating system for building digital interfaces. It provides SDK, APIs, and infrastructure to create composable surfaces at any scale.

Do I need coding experience to use PWFabric?

PWFabric is primarily designed for developers. Our SDK requires TypeScript/JavaScript knowledge. However, the PhiWebs product built on PWFabric offers a visual editor (PhiCo) for non-developers.

How do I get started?

Install the SDK via pnpm: pnpm add @phimajor-solutions/pwfabric-sdk. Then follow our Quick Start guide to create your first surface.

Can I use PWFabric with my existing stack?

PWFabric ships a React 19 SDK. Anything that can call a REST API and render React can consume PhiWebs Surfaces; framework adapters for Vue, Svelte, or vanilla JS are not part of the supported surface today.

Technical questions

What is a Surface?

A Surface is a composable digital interface built from blocks. Surfaces can be pages, dashboards, forms, or any other UI layout. They are defined declaratively and rendered by the PWFabric runtime.

What are Blocks?

Blocks are the building units of surfaces. Each block type (heading, text, button, container, image, etc.) encapsulates UI and behavior. Blocks can be nested, configured, and composed to create complex interfaces.

How does API authentication work?

The PWFabric API uses World-based authentication. Each request requires the X-World-ID header. For production, you also need a Bearer token in the Authorization header.

Can I create custom blocks?

Yes. Custom blocks are created by implementing the Block interface from @phimajor-solutions/pwfabric-core. You can define custom props, rendering logic, and editor components. See the SDK reference.

Is PWFabric open source?

No. The PWFabric SDK and platform are proprietary — All Rights Reserved. The packages are published to a private npm registry for licensed use, but the source is not open source and is not offered under MIT or any other open-source licence. The hosted runtime and World infrastructure are likewise proprietary and not available for self-host today.

Integration & deployment

Does PWFabric support SSO?

Yes. SSO with SAML 2.0 and OIDC is available on Enterprise plans. You configure providers in World settings → Security → SSO, or programmatically via the SSO admin API.

Can I use my own database?

PWFabric manages its own database for surface definitions and metadata. For your application data, you can integrate any database and connect it via data sources.

How do I deploy surfaces?

Surfaces publish to the PhiWebs hosted runtime. The publish API creates versioned deployments with instant rollback to any prior accepted Receipt.

Is there a rate limit on the API?

Rate limits are enforced per minute by endpoint tier, not as per-day caps:

  • Public: 100 requests/minute
  • Read: 60 requests/minute
  • Write: 30 requests/minute
  • Admin: 10 requests/minute
  • Auth: 5 requests/minute

See rate limits for the full per-tier breakdown.

Still have questions?

Google Workspace