Skip to content

astrisjs/astris.js

Repository files navigation

✨ Astris

Build at the speed of light.

A modern, type-safe, and blazingly fast fullstack framework built 100% on Bun.

GitHub Actions Workflow Status

Bun TypeScript License

About

Astris is a fullstack framework built from the ground up on Bun. It combines automatic file-based routing, type-safe APIs, SSR + SPA hydration, and the ability to deploy as a native binary — all with zero configuration.

Features:

  • 🚀 Blazingly fast (built on Bun, not Node.js)
  • 📁 File-based routing (intuitive and automatic)
  • 🔐 Fully type-safe (extracted from route definitions)
  • 🎯 Zero configuration (works out of the box)
  • 💾 SSR + SPA (server-side rendering with client hydration)
  • 🐍 Deploy as native binary (single executable)

Installation

Node.js 18.0.0 or newer is required.

bunx @astris/cli init my-app
cd my-app
bun install
bun run dev

Example Usage

Create a page

// src/routes/page.tsx
export default function Home() {
  return <h1>Welcome to Astris</h1>
}

Create an API route

// src/routes/api/hello/route.ts
export interface HelloResponse {
  message: string
}

export async function GET(): Promise<Response> {
  return Response.json({ message: 'Hello from Astris!' })
}

Dynamic routes

// src/routes/users/[id]/page.tsx
export default function User({ params }: { params: { id: string } }) {
  return <h1>User {params.id}</h1>
}

Documentation

Contributing

Before creating an issue, please ensure that it hasn't already been reported/suggested.

See the contribution guide if you'd like to submit a PR.

Help

If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle push in the right direction, please don't hesitate to join our official Discord Server.

License

Licensed under the MIT License

About

Build at the speed of light. A modern, type-safe, and blazingly fast fullstack framework built 100% on Bun.

Resources

License

Contributing

Stars

Watchers

Forks

Contributors