https://github.com/lightningkite/lightning-server

https://github.com/lightningkite/lightning-server

Last synced: 5 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/lightningkite/lightning-server
• Owner: lightningkite
• License: apache-2.0
• Created: 2022-07-08T21:39:44.000Z (about 4 years ago)
• Default Branch: version-5
• Last Pushed: 2026-02-05T23:04:16.000Z (5 months ago)
• Last Synced: 2026-02-06T08:48:32.157Z (5 months ago)
• Language: Kotlin
• Size: 11.1 MB
• Stars: 20
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt
  • Security: SECURITY_AND_QUALITY_ISSUES.md

Awesome Lists containing this project

• awesome-java - Lightning Server

README

          
# Lightning Server

A project that drastically speeds up server development.  Comparable to Django for Python.

Built to work for all common serverless platforms.

## Major Features

- Abstractions

  - Multiple backends - AWS, Azure, Ktor

    - Generates Terraform for AWS

  - Database Abstraction backed by KotlinX Serialization

    - Supports MongoDB, partial Postgres, local JSON storage

    - Also supports a RAM mock for unit testing

  - Cache Abstraction

    - Supports Redis, Memcached, DynamoDB

    - Also supports a RAM mock for unit testing

  - Email Abstraction

    - Supports SMTP, Amazon SES

    - Also supports a console mock for testing

  - SMS Abstraction

    - Supports Twilio and a console mock for testing

  - File System Abstraction

    - Supports Local, AWS S3, and Azure Blob Storage

- Easy Server Definitions

  - Simple HTTP Endpoint Definition

  - Typed API Endpoints

    - Typed input, output, and user

    - Supports many content types, including JSON, BSON, CBOR, CSV, FormData

  - Event-Based Websocket Definition

  - Scheduled tasks

  - Asynchronous tasks

  - Permission rules for users accessing databases

- Pre-built Route Sets

  - REST endpoints with permissions

  - Authentication endpoints

    - Email Magic Links

    - Email PIN

    - SMS PIN

    - Password

    - OAuth for Google, Apple, and GitHub

- Server management tools

  - Built-in database admin and endpoint tester 

  - Health check page

  - Built-in OpenAPI documentation

  - Automatically generated documentation for API

  - Automatically generated SDKs for TypeScript and Kotlin

## Documentation

- [Client Documentation](docs/use-as-client.md)

- [Set Up](docs/setup.md)

- [Settings](docs/settings.md)

- [Endpoints](docs/endpoints.md)

- [Serialization](docs/serialization.md)

- [Database](docs/database.md)

- [Cache](docs/cache.md)

- [Files](docs/files.md)

- [Email](docs/email.md)

- [Authentication](docs/authentication.md)

- [Typed Endpoints](docs/typed-endpoints.md)

- [Automatic REST Endpoints](docs/autorest.md)

- [Tasks](docs/tasks.md)

- [Websockets](docs/websockets.md) (todo)

- [Meta](docs/meta.md)

## Road Map

- [ ] Improved per-environment Terraform generation

- [ ] Key-path ordering and grouping

- [ ] Additional Documentation

- [ ] Tutorial

### When Requested

- [ ] Complete Azure Support

  - [X] CosmosDB (using MongoDB interface)

  - [X] Http Endpoints

  - [ ] WebSockets

  - [ ] Scheduled Tasks

  - [ ] Asynchronous Tasks

  - [ ] Generate Terraform

### Specifically Not Planned

- DynamoDB as Database Support - DynamoDB is unfortunately far too limited to fit our current abstraction.  If scan is able to be done in reverse in the future, this may become possible.