marketplaces/README.md

# Marketplace Frontend

Angular marketplace frontend for the client demonstration. The app uses standalone components, signals, runtime branding/configuration, and a production build optimized for the current marketplace experience.

## Features

- Responsive marketplace storefront
- Category browsing and product detail pages
- Search and shopping cart flows
- Telegram login integration
- Payment handoff through the existing backend contract
- Runtime branding and configuration loading
- PWA manifest and service worker configuration

## Development

Install dependencies:

```bash
npm install
```

Start the local development server:

```bash
npm start
```

Build for production:

```bash
npm run build
```

The production build is written to `dist/dexarmarket/`.

## Project Structure

```text
src/
├── app/
│   ├── components/          # Shared storefront components
│   ├── core/                # Runtime, config, guards, providers, interceptors
│   ├── dynamic-renderer/    # Page, section, and widget rendering pipeline
│   ├── facades/             # Runtime, website, builder, and backoffice facades
│   ├── pages/               # Storefront, info, legal, cart, search, and item pages
│   ├── services/            # API, cart, auth, SEO, Telegram, and language services
│   └── widgets/             # Dynamic renderer widgets
├── assets/mock/             # Local mock configuration and catalog data
├── environments/            # Development and production environment settings
└── styles/                  # Shared global styles and themes
```

## Useful Checks

```bash
npm run build
npm run arch:check
```

## Notes

- Authentication and payment integrations are intentionally left on their existing contracts.
- Renderer and runtime architecture should remain stable during demo preparation.
- Client-facing content should avoid placeholder names, mock labels, and temporary routes.