Theme structure

aurora/
├── package.json            # build scripts and dependencies
├── vite.config.mjs         # dev server and build configuration
├── tailwind.config.js
├── postcss.config.js
├── .env                    # committed defaults: AIKEEDO_SERVER, BUILD_DIR
├── scripts/
│   ├── pack.mjs            # builds and zips the installable theme
│   └── release.mjs         # wraps theme.zip into a versioned archive
├── release/
│   └── README.md           # shipped alongside theme.zip in the release archive
├── src/                    # compiled sources: not shipped as-is
│   ├── css/
│   │   ├── index.css       # CSS entry
│   │   ├── base.css
│   │   ├── button.css
│   │   ├── typography.css
│   │   └── avatar.css
│   └── js/
│       ├── index.js        # JS entry
│       ├── translate.js
│       └── components/     # custom elements
└── static/                 # the package: copied as-is into the build
    ├── composer.json
    ├── layouts/theme.twig
    ├── templates/
    │   ├── index.twig
    │   └── custom.twig
    ├── sections/header.twig
    ├── snippets/
    │   ├── css.twig
    │   ├── js.twig
    │   └── script-tags/{head,body,end}.twig
    ├── assets/             # static images, logos
    ├── src/                # optional PHP
    │   ├── Theme.php
    │   └── CustomView.php
    └── locale/{code}/LC_MESSAGES/theme.po

extra/extensions/acme/aurora/
├── composer.json
├── layouts/  templates/  sections/  snippets/  locale/  src/
├── assets/
│   ├── css-a1b2c3.css
│   ├── js-d4e5f6.js
│   └── logo.svg
└── .vite/manifest.json