https://github.com/thomas3577/alpine-server

https://github.com/thomas3577/alpine-server

alpinejs deno oak

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/thomas3577/alpine-server
• Owner: thomas3577
• License: mit
• Created: 2026-01-18T12:53:02.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2026-02-15T13:56:50.000Z (4 months ago)
• Last Synced: 2026-02-15T16:17:56.075Z (4 months ago)
• Topics: alpinejs, deno, oak
• Language: TypeScript
• Homepage: https://jsr.io/@dx/alpine-server
• Size: 73.2 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# @dx/alpine-server

[![JSR Version](https://jsr.io/badges/@dx/alpine-server)](https://jsr.io/@dx/alpine-server)

[![JSR Score](https://jsr.io/badges/@dx/alpine-server/score)](https://jsr.io/@dx/alpine-server/score)

[![ci](https://github.com/thomas3577/alpine-server/actions/workflows/deno.yml/badge.svg)](https://github.com/thomas3577/alpine-server/actions/workflows/deno.yml)

> ⚠️ **EXPERIMENTAL**: This library is in early development and highly experimental. APIs may change without notice. Not recommended for production use.

A secure, production-ready Oak (Deno) web server optimized for serving Alpine.js applications with built-in development tools, security hardening, and automatic hot-reloading.

## Versions

- **Oak**: v17.2.0

- **Alpine.js**: v3.15.8 (default configuration)

## Example

```typescript

import { AlpineApp } from '@dx/alpine-server';

const app = new AlpineApp({

  app: {

    dev: true,

    staticFilesPath: './public',

  },

  oak: {

    listenOptions: { port: 3000 },

  },

});

await app.run();

```

## CLI

Create a new Alpine Server project scaffold:

```sh

deno run -A jsr:@dx/alpine-server/cli new my-app

```

With options:

```sh

deno run -A jsr:@dx/alpine-server/cli new my-app --port 3000 --force

```

## Documentation

For more detailed information, please refer to the documentation in the [docs](./docs) folder:

- [Usage](./docs/USAGE.md)

- [Configuration](./docs/CONFIGURATION.md)

## License

MIT

## Contributing

Contributions welcome!