('Logger')
// Create container
const container = createContainer()
// Register service
container.register(LoggerToken, () => new ConsoleLogger())
// Resolve service
const logger = container.resolve(LoggerToken)
```
**Usage Pattern:**
See `apps/stage-tamagotchi/src/main/index.ts` for composition patterns.
## Database & Persistence
### DuckDB WASM
In-browser database for web and desktop:
```typescript theme={null}
import { drizzle } from '@proj-airi/drizzle-duckdb-wasm'
import { DuckDB } from '@proj-airi/duckdb-wasm'
// Initialize
const duckdb = await DuckDB.create()
const db = drizzle(duckdb)
// Query
const results = await db.select().from(users).where(eq(users.id, 1))
```
### Storage Solutions
| Storage | Use Case | Packages |
| --------------- | ------------------------------------- | ------------------------ |
| **DuckDB WASM** | Structured data (messages, analytics) | `@proj-airi/duckdb-wasm` |
| **LocalForage** | Key-value storage | `localforage` |
| **IndexedDB** | Large binary data | `idb-keyval` |
| **PostgreSQL** | Production services (Telegram bot) | `drizzle-orm` |
## Internationalization
Centralized translations in `packages/i18n/`:
```typescript theme={null}
import { useI18n } from 'vue-i18n'
const { t } = useI18n()
// Use in templates
{{ t('common.welcome') }}
// Use in code
const message = t('errors.network')
```
**Adding Translations:**
1. Add keys to `packages/i18n/locales/`
2. Never scatter i18n across apps/packages
3. Contribute to [Crowdin](https://crowdin.com/project/proj-airi) for translations
## Performance Considerations
### Web Performance
VAD and heavy computations run in Web Workers to avoid blocking the main thread.
Dynamic imports and route-based splitting reduce initial bundle size.
GPU acceleration for ML inference and 3D rendering where available.
DuckDB and ONNX Runtime use WebAssembly for near-native performance.
### Desktop Performance
The Electron app (`stage-tamagotchi`) can use:
* Native CUDA (NVIDIA)
* Metal (Apple)
* Native file system access
* Native audio/video APIs
### Mobile Performance
Capacitor (`stage-pocket`) bridges to native APIs:
* Native camera/microphone
* Push notifications
* Background tasks
* File system access
## Build System
### Turbo Orchestration
The monorepo uses Turbo for efficient builds:
```bash theme={null}
# Build all packages
pnpm build
# Build specific workspace
pnpm -F @proj-airi/stage-web build
# Build with filters
turbo run build --filter="./packages/*"
```
### Package Bundling
Packages use `tsdown` for bundling:
```typescript theme={null}
// tsdown.config.ts
import { defineConfig } from 'tsdown'
export default defineConfig({
entry: ['src/index.ts'],
format: ['esm'],
dts: true,
clean: true,
})
```
## Testing Strategy
### Unit Tests (Vitest)
```bash theme={null}
# Run all tests
pnpm test:run
# Run specific test file
pnpm exec vitest run apps/stage-tamagotchi/src/renderer/stores/tools/builtin/widgets.test.ts
# Run workspace tests
pnpm -F @proj-airi/stage-tamagotchi exec vitest run
```
### Testing Patterns
```typescript theme={null}
import { describe, it, expect, vi } from 'vitest'
describe('MyComponent', () => {
it('should render correctly', () => {
// Mock dependencies
const mockService = vi.fn()
// Test logic
expect(mockService).toHaveBeenCalled()
})
})
```
**Guidelines:**
* Mock IPC/services with `vi.fn()`/`vi.mock()`
* Don't rely on real Electron runtime
* Keep tests targeted for speed
* Use Vitest browser env where possible
## Configuration Files
### Key Configuration Locations
| File | Purpose |
| --------------------- | ---------------------- |
| `package.json` | Root workspace config |
| `pnpm-workspace.yaml` | Workspace definition |
| `tsconfig.json` | Base TypeScript config |
| `uno.config.ts` | UnoCSS configuration |
| `eslint.config.js` | ESLint rules |
| `vitest.config.ts` | Vitest configuration |
| `turbo.json` | Turbo pipeline config |
### Environment Variables
Common environment variables:
```bash theme={null}
# Server Runtime
SERVER_INSTANCE_ID=
AUTHENTICATION_TOKEN=
LOG_LEVEL=log|debug|warn|error
# Development
VITE_DEV_SERVER_URL=http://localhost:5173
CAPACITOR_DEV_SERVER_URL=https://:5273
```
## Next Steps
Learn how to create plugins for AIRI
Set up your development environment
Explore the API documentation
Check out example implementations