# Portal Structure Overview

This app follows a feature-first architecture with a consolidated `lib` for shared utilities.

Structure:

```
src/
  app/           # Next.js App Router
  components/    # Design system (ui, layout, common)
  features/      # Feature modules (auth, billing, subscriptions, ...)
  lib/           # Core utils and services (api, query, env, utils, types)
  providers/     # App-wide providers (e.g., QueryProvider)
  styles/        # Global styles
```

Key changes:

- Merged former `core/` and `shared/` into `lib/`.
- Moved `components/providers/query-provider.tsx` to `providers/query-provider.tsx`.
- Introduced path aliases: `@/lib/*`, `@/providers/*`.

Migration tips:

- Prefer importing from `@/lib/...` going forward.
- All `@/shared/*` or `@/core/*` imports have been removed; use `@/lib/*`.