# One 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.

- Skill: `onejs/one-guides` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add onejs/one-guides`
- Raw SKILL.md: https://api.skillmd.com/api/skills/onejs/one-guides/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: onejs (https://skillmd.com/u/onejs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/onejs/one-guides

---


# One Framework Guides

Official docs: [Guides Index](https://onestack.dev/docs/guides)

Recipes and patterns for common tasks when building with One.

## References

```
references/
  authentication.md       Session context, Protected routes, middleware auth, loader redirects, OAuth
  images.md               ?imagedata imports, blur placeholders, sharp, MDX frontmatter integration
  css.md                  .inline.css, layout CSS ordering, inlineLayoutCSS, CSS loading optimization
  dark-mode.md            @vxrn/color-scheme, Tamagui SSR-safe dark mode, MetaTheme
  tamagui.md              Tamagui setup with One, SSR-safe styling, Vite plugin, CSS extraction
  mdx.md                  @vxrn/mdx setup, syntax highlighting, SSG blog with MDX
  open-graph.md           Dynamic OG images with @vercel/og, custom fonts, caching
  isr.md                  Incremental Static Regeneration, cache headers, CDN patterns
  skew-protection.md      Handling stale bundles after deploys, proactive version polling
  native-builds.md        iOS prebuild, Xcode, EAS, Android, production builds
  common-issues.md        Troubleshooting SSR errors, React Native package issues, fetch on native
```