wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About
  • What is WinGet?

© 2026 winget.ragerworks.com

Loading...
Install FreakJS using Winget - wingetCollections
  1. Go back
  2. Packages
  3. FreakJS
FreakJS logo

FreakJS FreakJS

bun framework frontend javascript typescript
Use this command to install FreakJS:
winget install --id=FreakJS.FreakJS -e

FreakJS is a minimal frontend framework built on Bun, designed to simplify web development with zero runtime npm dependencies. It leverages file-based routing for intuitive navigation and supports Server-Side Rendering (SSR) along with Edge Functions for efficient performance.

Key Features:

  • Zero Runtime Dependencies: Built without npm runtime dependencies, ensuring enhanced security and reduced supply-chain risks.
  • File-Based Routing: Automatically maps files in the src/pages directory to routes, simplifying navigation and reducing configuration overhead.
  • SSR + Edge Functions: Combines Server-Side Rendering for SEO-friendly pages with Edge Functions for fast, dynamic content delivery.
  • Free Deployment: Outputs natively compatible builds for platforms like Vercel, Netlify, and Cloudflare Pages, enabling free deployment without backend costs.
  • TypeScript Support: Ships with TypeScript out of the box, ensuring robust code quality and developer productivity.

Audience & Benefit: Ideal for developers seeking a minimalistic framework without npm dependency risks. FreakJS provides secure, performant web development with built-in support for modern tools like Vercel and Netlify, enabling cost-effective scaling and seamless integration into existing workflows.

FreakJS can be installed via winget, making it easy to integrate into your development environment.

README

FreakJS

Bun-native frontend framework. Zero runtime dependencies. Edge-ready. Free to deploy.

Open in StackBlitz

FreakJS é um framework frontend minimalista e seguro, construído sobre Bun e W3C Web APIs. Sem risco de supply-chain do npm. Sem arquivos de configuração complexos. Deploy gratuito na Vercel, Netlify e Cloudflare Pages — sem backend.

Por que FreakJS?

O benchmark de tokens

Um teste real mediu quantos tokens do Claude Sonnet um modelo consome para montar um frontend completo a partir de um único prompt:

FrameworkTokens consumidosPrecisa de servidor
NestJS~1.100.000Sim
Next.js / Vite~900.000Não
Rails~300.000Sim
FreakJS< RailsNão

Rails ganhou em tokens por ter convenções rígidas e superfície de API previsível. O FreakJS usa a mesma filosofia — mas roda inteiramente no edge, sem servidor, sem custo de backend e com zero dependências npm em runtime.

O problema de segurança do npm

Todo npm install puxa um grafo de dependências que executa scripts postinstall arbitrários com suas credenciais. Ataques de supply-chain exploram exatamente isso. O FreakJS tem zero dependências npm em runtime — os únicos pacotes em devDependencies são as definições de tipos do Bun e o TypeScript, que nunca chegam à produção.

Hospedagem gratuita

O output do build segue nativamente a Vercel Build Output API v3. Páginas estáticas vão para o CDN. Páginas dinâmicas e rotas de API viram Edge Functions isoladas. Custo zero na escala hobby da Vercel e Netlify.

Pré-requisito

  • Bun >= 1.1.0 instalado na máquina

Instalação

FreakJS é instalado como um binário nativo — igual ao Bun e ao Deno. Instale uma vez, use para sempre em qualquer terminal.

Windows — Winget (recomendado)

Versions
0.1.0
Website
github.com
License
Last updated
6/16/2026
Download latest version
winget install freakjs

Windows — Scoop

irm get.scoop.sh | iex
scoop bucket add freakjs https://github.com/lucas-s-santos/FreakJS
scoop install freakjs/freakjs

Mac / Linux

curl -fsSL https://raw.githubusercontent.com/lucas-s-santos/FreakJS/main/install.sh | bash

Criar o primeiro projeto

Depois de instalado, em qualquer pasta do seu computador:

freakjs create meu-projeto
cd meu-projeto
bun run dev

Acesse http://localhost:3000 — a tela de boas-vindas do FreakJS abre automaticamente.

bun run build   # gera .vercel/output/ pronto para deploy

O que é gerado pelo freakjs create

O comando cria uma estrutura completa e pronta para rodar:

meu-projeto/
├── src/
│   ├── pages/
│   │   ├── index.tsx          # Tela de boas-vindas com logo FreakJS → /
│   │   └── api/
│   │       └── hello.ts       # API route de exemplo → /api/hello
│   └── components/            # Pasta para seus componentes
├── public/
│   └── icon.png               # Logo do FreakJS (favicon incluso)
├── package.json
├── tsconfig.json
└── .gitignore

Ao rodar bun run dev, o localhost:3000 abre com a tela de boas-vindas do FreakJS — fundo escuro, logo e nome do projeto — pronta para você substituir pelo seu conteúdo.

Roteamento

Cada arquivo em src/pages/ vira automaticamente uma rota — sem configuração:

ArquivoRotaTipo
src/pages/index.tsx/página
src/pages/sobre.tsx/sobrepágina
src/pages/blog/[slug].tsx/blog/:slugdinâmica
src/pages/docs/[...path].tsx/docs/:path*catch-all
src/pages/api/hello.ts/api/helloAPI

Prioridade: estática > dinâmica > catch-all.

Páginas

// src/pages/index.tsx
import type { PageProps } from "freakjs";

export const metadata = {
  title: "Meu App",
  description: "Feito com FreakJS",
};

export default function Home({ url, params, searchParams }: PageProps) {
  return (
    
      <h1>Olá, FreakJS</h1>
      <p>Caminho atual: {url.pathname}</p>
    
  );
}

PageProps

interface PageProps {
  params: Record;  // segmentos dinâmicos da URL
  searchParams: URLSearchParams;   // ?chave=valor
  url: URL;                        // URL completo
}

Metadata

export const metadata = {
  title: "Título da página",       // 
  description: "Descrição SEO",   // &lt;meta name="description"&gt;
};

Componentes

// src/components/Card.tsx
import type { VNode } from "freakjs";

interface CardProps {
  titulo: string;
  children?: VNode[];
}

export function Card({ titulo, children }: CardProps) {
  return (
    &lt;div style={{ background: "#111", borderRadius: "8px", padding: "16px" }}&gt;
      &lt;h2 style={{ color: "#fff", margin: "0 0 8px 0" }}&gt;{titulo}&lt;/h2&gt;
      {children}
    &lt;/div&gt;
  );
}

API Routes

// src/pages/api/hello.ts
export async function GET(req: Request): Promise&lt;Response&gt; {
  return Response.json({ message: "Olá do FreakJS!" });
}

export async function POST(req: Request): Promise&lt;Response&gt; {
  const body = await req.json();
  return Response.json({ recebido: body }, { status: 201 });
}

Métodos não implementados retornam 405 Method Not Allowed automaticamente.

Usando Supabase (sem backend)

// src/pages/api/posts.ts
import { createClient } from "@supabase/supabase-js";

const supabase = createClient(
  process.env.SUPABASE_URL!,
  process.env.SUPABASE_ANON_KEY!,
);

export async function GET(): Promise&lt;Response&gt; {
  const { data, error } = await supabase.from("posts").select("*");
  if (error) return Response.json({ error: error.message }, { status: 500 });
  return Response.json(data);
}

Configure as variáveis de ambiente no painel da Vercel ou Netlify.

Deploy

Vercel

bun run build
vercel deploy --prebuilt

Ou conecte seu repositório GitHub na Vercel e defina o build command como bun run build. A Vercel detecta .vercel/output/ automaticamente.

Netlify

Aponte o diretório de publicação para .vercel/output/static.

Output do build

.vercel/output/
├── config.json                    # Regras de rota (Build Output API v3)
├── static/
│   ├── index.html                 # Páginas pré-renderizadas
│   └── _freakjs/
└── functions/
    ├── blog/[slug].func/
    │   ├── index.js               # Edge Function empacotada
    │   └── .vc-config.json
    └── api/hello.func/
        ├── index.js
        └── .vc-config.json

Servidor de desenvolvimento

bun run dev   # → http://localhost:3000
  • HMR — mudanças nos arquivos recarregam o browser via WebSocket
  • SSR em dev — idêntico à produção
  • API routes funcionam localmente — sem mock, sem processo separado

Segurança

Vetor de ataqueComo o FreakJS lida
Supply-chain npmZero dependências runtime — nada para envenenar
Scripts postinstallSem dependências runtime com lifecycle scripts
XSSTodo texto HTML-escapado por padrão no renderToString
Injeção via event handlersAtributos on* removidos do SSR; reattached só no cliente
Isolamento edgeCada função roda em isolate V8 próprio (Vercel/Cloudflare)

CLI

freakjs &lt;comando&gt;

Comandos:
  create &lt;nome&gt;   Cria um novo projeto FreakJS com tela de boas-vindas
  dev             Inicia o servidor de desenvolvimento (porta 3000)
  build           Build de produção (Vercel Build Output API v3)

API pública

"freakjs"

ExportDescrição
h, jsx, jsxs, jsxDEVJSX factory (usado pelo compilador TypeScript)
FragmentSuporte a &lt;&gt;...&lt;/&gt;
renderToString(vnode)Renderiza VNode para string HTML
hydrate(vnode, container)Attaches event listeners no DOM existente
PageProps, PageMetadata, PageModule, ApiModuleTypes
VNode, VNodeChild, FunctionComponentTypes do JSX

Roadmap

  • Adapter Netlify Edge Functions
  • Adapter Cloudflare Pages
  • Estado reativo (signals, sem VDOM)
  • Otimização nativa de imagens
  • CSS modules

Criadores

FreakJS foi criado e é mantido por:

João Gabriel do Vale Souza e Lucas Silva dos Santos

Licença

MIT © 2025 João Gabriel do Vale Souza & Lucas Silva dos Santos

O copyright está registrado no arquivo LICENSE e no cabeçalho de todos os arquivos de código-fonte. Qualquer uso, cópia ou distribuição deve manter os créditos originais conforme a licença MIT.