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 @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 @pwfabric/core. You can define custom props, rendering logic, and editor components. See the SDK reference.

Is PWFabric open source?

The PWFabric SDK is open source under MIT. The hosted runtime, World infrastructure, and operator console are 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 — Cloudflare edge cache in front of an Azure-hosted origin (per ADR-149). The publish API creates versioned deployments with instant rollback to any prior accepted Receipt.

Is there a rate limit on the API?

  • Basic: 5,000 requests/day
  • Pro: 100,000 requests/day
  • Team: 500,000 requests/day
  • Enterprise: Unlimited with dedicated infrastructure

Still have questions?

Slack