shopathome copilot-instructions.md

Copilot Instructions — Shop at Home

Language & Framework Conventions

JavaScript / TypeScript

• Use const and let — never var.
• Prefer arrow functions for callbacks and inline functions.
• Use template literals for string interpolation.
• Use async/await over raw Promises where possible.
• TypeScript (Angular and Svelte apps): use explicit types for function parameters and return values. Avoid any.

Angular (angular-app)

• Follow Angular CLI conventions: one component per file, *.component.ts / *.service.ts / *.module.ts suffixes.
• Use NgRx for state management — actions, reducers, effects, selectors follow the NgRx pattern in src/app/.
• Use Angular's dependency injection for services.
• Router configuration lives in src/app/router.ts.
• Templates use Angular template syntax with structural directives (*ngIf, *ngFor).
• Lint with TSLint (tslint.json at src/tslint.json).

React (react-app)

• Class components are not used — prefer functional components.
• State management uses Redux with Redux-Saga for side effects (see src/store/).
• Follow the Airbnb ESLint configuration (.eslintrc.json extends react-app).
• Format with Prettier (.prettierrc).
• Router uses react-router-dom v6.

Svelte (svelte-app)

• Use TypeScript in Svelte components (<script lang="ts">).
• Styling uses SCSS imported globally from src/styles.scss.
• Build with Vite (vite.config.ts).
• Check types with npm run check (svelte-check).
• Store module in src/store/ — uses Svelte writable stores.

Vue (vue-app)

• Single-File Components (.vue) with <template>, <script>, <style> sections.
• State management via Vuex (src/store/).
• Routing via Vue Router (src/router.js).
• Follow Vue ESLint + Airbnb + Prettier rules (.eslintrc.js).
• Component filenames use kebab-case.

API — Azure Functions (api/)

• Each function is a directory with function.json (bindings) and index.js (handler).
• Handlers receive (context, req) and set response via context.res.
• Shared data logic lives in api/shared/.
• Routes are defined declaratively in function.json, not in code.