{"id":15105396,"url":"https://github.com/foretaginc/forge","last_synced_at":"2026-01-19T15:11:13.528Z","repository":{"id":254417206,"uuid":"846370821","full_name":"ForetagInc/forge","owner":"ForetagInc","description":"WIP: 🔋 included fullstack meta framework built on React and Surreal","archived":false,"fork":false,"pushed_at":"2024-09-18T07:36:21.000Z","size":87,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-05T12:42:51.696Z","etag":null,"topics":["forge","framework","react","surrealdb"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ForetagInc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"foretag"}},"created_at":"2024-08-23T04:15:17.000Z","updated_at":"2024-09-18T07:36:25.000Z","dependencies_parsed_at":"2024-08-23T10:48:20.724Z","dependency_job_id":"2f07b81f-fc0c-4820-bd52-cfefb818329c","html_url":"https://github.com/ForetagInc/forge","commit_stats":{"total_commits":4,"total_committers":1,"mean_commits":4.0,"dds":0.0,"last_synced_commit":"acc56c7c6ed55b3e0dd9b7393554a8cdd2ea73ca"},"previous_names":["foretaginc/forge"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForetagInc%2Fforge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForetagInc%2Fforge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForetagInc%2Fforge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForetagInc%2Fforge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ForetagInc","download_url":"https://codeload.github.com/ForetagInc/forge/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247339134,"owners_count":20923009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["forge","framework","react","surrealdb"],"created_at":"2024-09-25T20:23:53.164Z","updated_at":"2026-01-19T15:11:13.522Z","avatar_url":"https://github.com/ForetagInc.png","language":"TypeScript","readme":"# Forge\n\nForge is a comprehensive enterprise meta-framework optimized for high-performance web application development on edge platforms like Cloudflare Pages (Workers) or Bun. Tailored for organizations seeking a unified approach to multiple web applications, Forge offers a batteries-included solution built on Vite, SurrealDB, GraphQL, Tailwind, and Valtio for exceptional speed and flexibility.\n\nAs the definitive universal platform, the web empowers developers to create web apps (PWAs) that seamlessly deploy across diverse devices, including web, desktop, mobile, TV, XR, and wearables. Given its adaptability, Forge prioritizes the web and PWAs as its primary platforms, eschewing the limitations of platform-specific solutions like Capacitor, Electron, and native development, which may become outdated in the face of evolving ecosystems.\n\nFullstack fulltime: Forge leverages SurrealDB as a web database, streamlining Auth, CRUD operations, ML Pipelines and API requests. By leveraging Surreal's Events and Functions, you can interact with data in a type-safe manner, with Forge handling the GraphQL integration for seamless DX and zero cost abstractions.\n\n## Features\n- [ ] Multisite: Create multisites in one codebase\n- [ ] SaaS Templating: Create SaaS apps with ease\n- [x] Built for React 18 \u0026 19 with Suspense \u0026 RSC\n- [x] State management with Proxy states \u0026 Signals\n- [ ] CSS: Modules \u0026 Tailwind (v4) out of the box\n- [ ] Markdown: MD and MDX out of the box\n- [ ] File based routing: Advanced nested routing patterns with layouts and groups\n- [ ] Surreal as backend: Accessible via type-safe GraphQL\n- [ ] Rendering with CSR, SSR, SSG and ISR\n\t- [x] CSR\n\t- [\t] SSR\n\t- [ ] SSG\n\t- [ ] ISR\n- [x] Deployments for Cloudflare Pages and Bun\n- [ ] Automatic ENV Variables\n\n## Installation\n\nForge can be installed through Bun and JSR:\n\n```bash\nbun create forge my-app\n```\n\n\u003e Please note Node, Deno and other runtimes are not supported officially\n\n### State Management\nYou can use component level statement with React `useState`, and `Context` for global scope; Forge also ships its own state management system built on top of valtio offering maximum performance and flexibility.\n\n```tsx\n// store.ts\nimport { createStore } from '@foretag/forge';\n\n// Optional\ntype Store = {\n\tcount: number\n};\n\nconst store = createStore\u003cStore\u003e({\n  count: 0\n});\n\n// App.tsx\nimport { useSignal } from '@foretag/forge';\n\nimport { store } from '@/lib/store';\n\nconst App = () =\u003e {\n  const count = useSignal(store.count);\n\n  return \u003cdiv\u003e\n    Count: {$(state).count} ({Math.random()})\n  \u003c/div\u003e;\n}\n```\n\n### FAQ\n\n- What runtimes are supported?\n\nForge supports Bun (for Development and Deploy) and Cloudflare Workers as an edge runtime. Other runtimes may work but are unsupported. JSR is the preferred package registry.\n\n- How to use Forge in a monorepo?\n\nUnlike other meta frameworks, you only need one Forge project in your monorepo (although you can have more) to service all of your projects. The recommeded setup would be to install Forge under a `sites` directory.\n\n### Limitations\n\nWe are aware of these notable limitations in Forge, and working towards resolving them:\n\n- Custom Vite configuration and plugins\n- Currently it is not possible to use the React 19 Compiler as it relies on Babel\n","funding_links":["https://opencollective.com/foretag"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforetaginc%2Fforge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforetaginc%2Fforge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforetaginc%2Fforge/lists"}