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