// sdk · React
React companion для @astroway/sdk
Офіційний `@astroway/react` на npm — тонка обгортка над `@astroway/sdk` у Stripe-стилі. `AstrowayProvider` піднімає клієнт через React context, хуки `useAstroway`, `useAstrowayQuery`, `useNatalChart` повертають SWR-подібний `{ data, error, loading }` без зовнішніх залежностей. Працює з React 18+, Next.js App Router (через "use client"), Vite, CRA.
// 01 / install
Встановити
npm install @astroway/react @astroway/sdk react імпорт: import { AstrowayProvider, useNatalChart } from '@astroway/react';
Дивитися в реєстрі → @astroway/react
// 02 / highlights
Особливості
- AstrowayProvider context
- useAstrowayQuery + useNatalChart
- Zero deps beyond react
- Stripe-style companion
- Full TypeScript types з @astroway/sdk
// 03 / first request
Перший запит
import { AstrowayProvider, useNatalChart } from '@astroway/react';
function App() {
return (
<AstrowayProvider options={{ apiKey: import.meta.env.VITE_AW_KEY }}>
<Chart />
</AstrowayProvider>
);
}
function Chart() {
const { data, error, loading } = useNatalChart({
date: '1990-07-14',
time: '14:30:00',
timezoneOffset: 3,
latitude: 50.4501,
longitude: 30.5234,
});
if (loading) return <p>Loading…</p>;
if (error) return <p>Error: {error.message}</p>;
return <pre>{JSON.stringify(data, null, 2)}</pre>;
}Старт з React
10 000 credits безкоштовно на місяць. Open-source SDK, генерується з OpenAPI 3.1, завжди синхронний з бекендом.