Skip to content
Back to search

foldkit

Build faster. Understand what ships.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/foldkit/foldkit with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/foldkit/foldkit'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/foldkit--foldkit/badge.svg)](/listings/foldkit--foldkit)

HTML

<a href="/listings/foldkit--foldkit"><img src="/api/listings/foldkit--foldkit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "foldkit",
  3. "owner": {
  4. "name": "Foldkit"
  5. },
  6. "plugins": [
  7. {
  8. "name": "foldkit-skills",
  9. "source": "./",
  10. "description": "Skills for building Foldkit programs — generate complete apps from descriptions, with architecture conventions baked in."
  11. }
  12. ]
  13. }
README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="packages/website/public/logo-dark.svg">
  4. <source media="(prefers-color-scheme: light)" srcset="packages/website/public/logo.svg">
  5. <img src="packages/website/public/logo.svg" alt="Foldkit" width="350">
  6. </picture>
  7. </p>
  8. <p align="center">
  9. <a href="https://www.npmjs.com/package/foldkit"><img src="https://img.shields.io/npm/v/foldkit" alt="npm version"></a>
  10. </p>
  11. <h3 align="center">Build faster. Understand what ships.</h3>
  12. <p align="center">
  13. <a href="https://foldkit.dev"><strong>Documentation</strong></a> · <a href="https://foldkit.dev/introduction/why-foldkit"><strong>Why Foldkit</strong></a> · <a href="https://foldkit.dev/example-apps"><strong>Examples</strong></a> · <a href="https://foldkit.dev/get-started"><strong>Get Started</strong></a> · <a href="https://discord.gg/kav8VNxqGm"><strong>Discord</strong></a>
  14. </p>
  15. ---
  16. Foldkit is a TypeScript frontend framework built on [Effect](https://effect.website/). It makes state and side effects explicit, so your team and AI agents can build features faster, trace behavior, and test changes with confidence.
  17. React, Vue, Svelte, and Solid solve rendering and leave the architecture to you. Foldkit gives you the architecture, so you can focus on your domain.
  18. Foldkit uses [The Elm Architecture](https://guide.elm-lang.org/architecture/). Application state does not live in component instances or hook lifecycles. The Model is the single source of truth, and every transition stays visible in update. That discipline is a real commitment. Foldkit works best when the team wants one architecture across the application and is ready to build on Effect throughout. [Coming from React?](https://foldkit.dev/react/coming-from-react)
  19. > [!NOTE]
  20. > Foldkit is pre-1.0 and under active development. The architecture is settled and the core API is stable in practice, but breaking changes may occur in minor releases. See the [roadmap](https://foldkit.dev/introduction/roadmap).
  21. ## Get Started
  22. Scaffold a browser-only app, a statically generated site, or a server-rendered app with `create-foldkit-app`:
  23. ```bash
  24. npx create-foldkit-app@latest
  25. ```
  26. The [Get Started guide](https://foldkit.dev/get-started) covers the generated project and how to run it.
  27. ## Counter
  28. This complete program defines the Model, Messages, update, init, and view in `main.ts`. `entry.ts` starts the Runtime separately, so tests can import the program without booting it.
  29. ```ts
  30. // src/main.ts
  31. import { Schema } from 'effect'
  32. import { Runtime, Update } from 'foldkit'
  33. import { Document, HtmlBuilder } from 'foldkit/html'
  34. import { defineMessageUnion } from 'foldkit/message'
  35. import { modifyFields } from 'foldkit/struct'
  36. // MODEL
  37. export const Model = Schema.Struct({ count: Schema.Number })
  38. export type Model = typeof Model.Type
  39. // MESSAGE
  40. export const Message = defineMessageUnion({
  41. ClickedDecrement: {},
  42. ClickedIncrement: {},
  43. ClickedReset: {},
  44. })
  45. export type Message = typeof Message.Type
  46. // UPDATE
  47. export const update = (model: Model, message: Message) =>
  48. Message.match<Update.Return<Model, Message>>(message, {
  49. ClickedDecrement: () => ({
  50. model: modifyFields(model, { count: count => count - 1 }),
  51. }),
  52. ClickedIncrement: () => ({
  53. model: modifyFields(model, { count: count => count + 1 }),
  54. }),
  55. ClickedReset: () => ({ model: modifyFields(model, { count: () => 0 }) }),
  56. })
  57. // INIT
  58. export const init: Runtime.ApplicationInit<Model, Message> = () => ({
  59. model: { count: 0 },
  60. })
  61. // VIEW
  62. export const view = (model: Model, h: HtmlBuilder<Message>): Document => ({
  63. title: `Counter: ${model.count}`,
  64. body: h.div(
  65. [],
  66. [
  67. h.p([], [model.count.toString()]),
  68. h.button([h.OnClick(Message.ClickedDecrement())], ['-']),
  69. h.button([h.OnClick(Message.ClickedReset())], ['Reset']),
  70. h.button([h.OnClick(Message.ClickedIncrement())], ['+']),
  71. ],
  72. ),
  73. })
  74. ```
  75. ```ts
  76. // src/entry.ts
  77. import { Runtime } from 'foldkit'
  78. import { Model, init, update, view } from './main'
  79. const application = Runtime.makeApplication({
  80. Model,
  81. init,
  82. update,
  83. view,
  84. container: document.getElementById('root'),
  85. })
  86. Runtime.run(application)
  87. ```
  88. Try [Counter in the browser](https://foldkit.dev/example-apps/counter), follow the [walkthrough](https://foldkit.dev/core/counter-example), or explore the [source](https://github.com/foldkit/foldkit/tree/main/examples/counter).
  89. ## What Ships With Foldkit
  90. - **Handle side effects:** Use [Commands](https://foldkit.dev/core/commands) for one-time work, [Subscriptions](https://foldkit.dev/core/subscriptions) for external events, [Mounts](https://foldkit.dev/core/mount) for element lifecycles, and [ManagedResources](https://foldkit.dev/core/managed-resources) for stateful handles.
  91. - **Build pages and embedded apps:** Add [routing](https://foldkit.dev/core/routing-and-navigation), [server rendering](https://foldkit.dev/core/server-rendering), or [embedding](https://foldkit.dev/core/embedding).
  92. - **Grow an interface:** Compose [Submodels](https://foldkit.dev/core/submodel) and [UI components](https://foldkit.dev/ui/overview).
  93. - **Test and debug behavior:** Use [Story and Scene testing](https://foldkit.dev/testing) and [DevTools](https://foldkit.dev/core/devtools) to trace state changes.
  94. - **Inspect an app with AI agents:** [DevTools MCP](https://foldkit.dev/ai/mcp) exposes the running Model and Message history.
  95. ## Examples
  96. - [Form](https://foldkit.dev/example-apps/form): validation with an async email check
  97. - [Auth](https://foldkit.dev/example-apps/auth): Submodels and OutMessage
  98. - [WebSocket Chat](https://foldkit.dev/example-apps/websocket-chat): a ManagedResource for a live connection
  99. - [Pixel Art](https://foldkit.dev/example-apps/pixel-art): interactive editor with keyboard shortcuts and persistence
  100. - [Typing Game](packages/typing-game): multiplayer game with an Effect RPC backend ([play it live](https://typingterminal.com))
  101. Explore the [full example gallery](https://foldkit.dev/example-apps).
  102. ## Development
  103. See [CONTRIBUTING.md](./CONTRIBUTING.md) to work on Foldkit and [AGENTS.md](./AGENTS.md) for code conventions. Community projects can use the Foldkit name and logo under the [branding guidelines](./BRANDING.md).
  104. ## License
  105. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.