Skip to content
Back to search

faasjs

πŸš€ FaasJS is an agent-friendly full-stack TypeScript framework for building predictable, type-safe applications with minimal dependencies.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

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

HTML

<a href="/listings/faasjs--faasjs"><img src="/api/listings/faasjs--faasjs/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.

README.md Β· README Β· 75 lines

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

  1. # πŸš€ FaasJS
  2. [![License: MIT](https://img.shields.io/npm/l/faasjs.svg)](https://github.com/faasjs/faasjs/blob/main/packages/faasjs/LICENSE)
  3. [![NPM Version](https://img.shields.io/npm/v/faasjs.svg)](https://www.npmjs.com/package/faasjs)
  4. [![Last commit](https://img.shields.io/github/last-commit/faasjs/faasjs)](https://github.com/faasjs/faasjs)
  5. [![Unit Status](https://github.com/faasjs/faasjs/actions/workflows/unit.yml/badge.svg)](https://github.com/faasjs/faasjs/actions/workflows/unit.yml)
  6. [![Coverage Status](https://img.shields.io/codecov/c/github/faasjs/faasjs.svg)](https://app.codecov.io/gh/faasjs/faasjs)
  7. [![Commits](https://img.shields.io/github/commit-activity/y/faasjs/faasjs)](https://github.com/faasjs/faasjs)
  8. [![Downloads](https://img.shields.io/npm/dm/@faasjs/types)](https://github.com/faasjs/faasjs)
  9. [![Pull requests](https://img.shields.io/github/issues-pr-closed/faasjs/faasjs)](https://github.com/faasjs/faasjs/pulls)
  10. [![faasjs/nginx](https://img.shields.io/badge/Docker-faasjs%2Fnginx-blue)](https://hub.docker.com/repository/docker/faasjs/nginx)
  11. [![faasjs/vscode](https://img.shields.io/badge/Docker-faasjs%2Fvscode-blue)](https://hub.docker.com/repository/docker/faasjs/vscode)
  12. [![faasjs/node](https://img.shields.io/badge/Docker-faasjs%2Fnode-blue)](https://hub.docker.com/repository/docker/faasjs/node)
  13. πŸš€ FaasJS is a Rails-inspired, curated full-stack TypeScript framework for database-driven React business applications.
  14. It provides a chef-selected default path across React, Ant Design, typed APIs, PostgreSQL, validation, testing, plugins, and project conventions so teams can build predictable products without repeatedly assembling their own framework.
  15. The official frontend path is React. The curated business-app stack uses `@faasjs/ant-design` for UI, `@faasjs/pg` for PostgreSQL workflows, and agent-readable conventions for complete UI β†’ API β†’ DB β†’ test slices.
  16. ## Why FaasJS?
  17. FaasJS is not trying to be the most general React framework. Next.js and TanStack Start focus on application rendering, routing, server functions, caching, and deployment models. FaasJS focuses on the repeated work inside database-driven business products: tables, forms, typed APIs, validation, PostgreSQL queries, migrations, background jobs, tests, and project conventions that stay easy to inspect.
  18. Choose FaasJS when you want one maintained path for building complete business features, instead of assembling and governing React, API, database, UI, and testing choices for every project.
  19. The strongest fit is:
  20. - admin panels and back-office systems
  21. - internal tools and business workflow apps
  22. - SaaS dashboards and authenticated product consoles
  23. - BFF/API layers backed by typed contracts and PostgreSQL
  24. - AI product surfaces that need dashboards, jobs, APIs, or operational workflows
  25. ## Features
  26. ### Curated default stack
  27. βœ… React, Ant Design, PostgreSQL, Vitest, and Vite Plus working together.
  28. βœ… Strong defaults for database-driven admin panels, internal tools, SaaS dashboards, and BFF/API layers.
  29. βœ… Replaceable choices without turning alternatives into parallel first-class tracks.
  30. ### Typed full-stack workflow
  31. βœ… `defineApi` endpoints with explicit schemas and typed contracts.
  32. βœ… Shared API types across backend handlers and React clients.
  33. βœ… PostgreSQL query, migration, and testing workflows through `@faasjs/pg` and `@faasjs/pg-dev`.
  34. ### Agent-readable conventions
  35. βœ… Stable file conventions and routing rules.
  36. βœ… Complete application slices that are easy for humans and AI coding agents to inspect, review, and refactor.
  37. βœ… Plugin patterns for business-specific concerns such as auth context and permissions.
  38. ## Learn more
  39. πŸ‘‰ Visit [faasjs.com](https://faasjs.com) to learn more.
  40. πŸ”¨ Start with [`create-faas-app`](https://github.com/faasjs/faasjs/tree/main/packages/create-faas-app), using the `admin` template for the curated React + Ant Design + PostgreSQL path.
  41. πŸ“š Read the [Guide](https://faasjs.com/guide/) for conventions, typed APIs, React data fetching, Ant Design, PostgreSQL, and testing.
  42. πŸ“¦ Explore runnable [templates](https://github.com/faasjs/faasjs/tree/main/templates) and future application slice examples.
  43. πŸ“„ See recent updates in the [CHANGELOG](https://faasjs.com/CHANGELOG.html).
  44. ❓ Get help or ask question in [Discussions](https://github.com/orgs/faasjs/discussions).

Ratings and comments

Sign in to rate this skill.

Sign in

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