What is an App?
In PhiWebs Studio, each project is one app. You describe what you want in the chat, the agent builds it, and the app runs in a live preview while you work. When you publish, the same app goes live at its own address.
An app is not a single page. It is a working whole: its pages, the records those pages read and write, the rules for who may do what, and the look that ties them together.
What an app is made of
| Part | What it does | Where it lives in the project | Read more |
|---|---|---|---|
| Pages | The screens of the app, built from blocks and patterns. One page is the entry page. | app/surfaces/ | Blocks |
| Navigation & look | The app’s menu links and its theme: colours, fonts, spacing. | app/definitions/navigation.json, app/definitions/appearance.json | Blocks |
| Data models | The kinds of records the app keeps, such as Booking or Product, and their fields. | app/definitions/entities.json | Data & records |
| Content and sample records | Records that ship with the app (a menu, a schedule) and starting records for a model. | app/content/, app/data/ | Data & records |
| Access rules and roles | Who may create, read, change or delete each kind of record, and the visitor sign-in. | app/definitions/auth.json | Sign-in & roles |
| Packs | The blocks, capabilities, patterns and themes the app is built from, at fixed versions. | pwpack.json | Packs & the marketplace |
| Images | Images you upload or generate in the studio’s Images panel. | media/ | Working in the studio |
You never have to edit these files yourself — the agent does that from the chat. You can read every one of them in the studio’s Files panel, and the studio’s other panels show the same things in plain form: Packs, Images, and the App panel for sign-in, people, records and connections.
Where an app lives
A project belongs to the workspace that created it. The workspace’s members are the people who build its apps; there is no separate sharing per project.
Published apps share nothing with each other. Each one keeps its own records, its own people list and its own sign-in sessions, so two apps in the same workspace never see each other’s data.
An app has an address
When you publish, the app goes live at https://<app>.phiwebs.app. The
address stays the same every time you publish again, so links you have shared
keep working. Visitors see only what you published; the preview you build in
runs at a separate address of its own. See Preview & versions.
Publishing is not the only way out. The studio’s Export menu gives you:
- Download project — a
.pwpackfile with the app’s full source. You can start a new project from it later. - Download web app — the built site, ready to host anywhere.
See Publishing your app.
How an app changes
You change an app by asking for the change in the chat. The agent edits the project, checks it, and the preview reloads. Every change is saved in the project’s History, and you can restore any earlier version from there.
Nothing reaches your visitors until you press Publish.