OneKey Coding Patterns and Best Practices
Quick Reference
Topic Guide Key Points
Promise handling promise-handling.md Always await or use void , never floating promises
React components react-components.md Named imports, functional components, no FC type
Restricted patterns restricted-patterns.md Forbidden: toLocaleLowerCase , direct hd-core import
Critical Rules Summary
Promise Handling
// ❌ FORBIDDEN - floating promise apiCall();
// ✅ CORRECT await apiCall(); // or void apiCall(); // intentionally not awaited
React Components
// ❌ FORBIDDEN import React, { FC } from 'react'; const MyComponent: FC<Props> = () => {};
// ✅ CORRECT import { useState, useCallback } from 'react'; function MyComponent({ prop }: { prop: string }) {}
Restricted Patterns
// ❌ FORBIDDEN string.toLocaleLowerCase() import { x } from '@onekeyfe/hd-core'; import { localDbInstance } from '...';
// ✅ CORRECT string.toLowerCase() const { x } = await CoreSDKLoader(); import { localDb } from '...';
Related Skills
-
/1k-date-formatting
-
Date and time formatting
-
/1k-i18n
-
Internationalization and translations
-
/1k-error-handling
-
Error handling patterns
-
/1k-cross-platform
-
Platform-specific code
-
/1k-code-quality
-
Linting and code quality
-
/1k-performance
-
Performance optimization
-
/1k-state-management
-
Jotai atom patterns
-
/1k-architecture
-
Project structure and import rules
-
/1k-code-quality
-
Lint fixes, pre-commit tasks