Project layout#

What the scaffold gives you and where things live.

Structure#

hello-lynx/
├── src/
│   ├── App.tsx          # root component
│   └── screens/         # one file per screen
├── lynx.config.ts       # build plugin config (BG/MT bundles)
├── ios/                 # generated by `sigx prebuild`
└── android/             # generated by `sigx prebuild`

The two bundles#

The build plugin compiles your source twice: a background bundle (your components and signals) and a main-thread bundle (worklets, animation drivers). You rarely think about this — @sigx/lynx-plugin handles the split and the worklet transform.

Native projects#

ios/ and android/ are generated — treat them as build output. Re-run sigx prebuild after adding native modules; the autolinker wires them up.