README

Starter application template for Thorm, a PHP-first UI framework that compiles a declarative DSL into a small JavaScript runtime through a shared IR.

Status

Thorm App is currently in pre-alpha / developer preview.

• APIs may change without backward compatibility
• project structure and build flows may change
• suitable for evaluation, experimentation, and early integration work

Create a project

Use Composer to create a new Thorm app:

composer create-project bitforge/thorm-app hello-thorm

Because Thorm is currently pre-alpha, installation may require an explicit alpha constraint depending on the published version.

Project structure

A generated project is expected to look like this:

hello-thorm/
  src/
    assets/
    php/
    runtime/
  vendor/
  index.html
  index.ir.json
  composer.json

What this package provides

bitforge/thorm-app is a starter project package.

It gives you:

• an initial Thorm app structure
• a place for your PHP UI code under src/php
• assets and runtime files under src/assets and src/runtime
• a root index.html
• a Composer-based dependency on bitforge/thorm

Framework dependency

This starter app depends on the Thorm framework package:

composer require bitforge/thorm:^0.1@alpha

If you want to add Thorm to an existing PHP project instead of creating a new one, install the framework package directly rather than using create-project.

Development

Typical workflow:

1. edit your app in src/php
2. build the app to generate index.html and index.ir.json
3. serve the project with a local static or PHP web server

Exact build commands may change during the pre-alpha phase.

Learn more

• Framework repo: https://github.com/scarpelius/thorm
• Framework package: bitforge/thorm

License

Apache-2.0