building-with-one
One Framework Guide
Official docs: Introduction, Installation, Configuration
One is a full-stack React framework targeting both web and React Native with a single codebase. Built on Vite with file system routing, server-side loaders, and flexible render modes (SSG, SSR, SPA). For native builds, One supports Metro (recommended) and an experimental Vite bundler.
References
Consult these resources as needed:
references/
routing.md File conventions, dynamic routes, groups, parallel routes, intercepting routes, typed routes
layouts.md _layout.tsx, Stack (+ Header Composition API), Tabs, Drawer, Slot, NativeTabs, nested layouts
navigation.md Link (mask, scroll, asChild), useRouter, useLinkTo, Protected, Redirect, route masking
components.md Head (+ iOS Handoff/Spotlight), SafeAreaView, ScrollBehavior, LoadProgressBar, withLayoutContext
hooks.md All hooks: useParams, useSearchParams, useActiveParams, useSegments, useMatches, useBlocker, etc.
configuration.md vite.config.ts, one() plugin options, web/native/global settings, env vars
render-modes.md SSG, SSR, SPA, API per-page and global, folder suffixes, layout render modes
More from onejs/skills
one-deployment
Deploy One framework apps to Node servers, Vercel, Cloudflare Workers, or as static sites. Covers build, serve, cluster mode, security scanning, and platform-specific configuration.
1one-guides
Guides and recipes for One framework. Covers authentication, images, CSS optimization, dark mode, Tamagui, MDX, OpenGraph images, ISR, skew protection, native iOS builds, EAS, CRA migration, and common issues.
1one-render-modes
Configure render modes (SSG, SSR, SPA, API) in One framework. Use when choosing how pages are rendered, setting up static generation, or mixing render strategies.
1one-loaders
Server-side data loading in One framework. Use when fetching data for pages, implementing caching, redirects, response headers, ISR, refetching, or file-driven content with loaders.
1one-api-routes
Create API routes in One framework. Use when building HTTP endpoints, webhooks, REST APIs, or server-side logic with +api.ts files.
1