GitHub - schematra/schematra: sinatra inspired scheme web framework

Schematra

Write web apps the way you think

A modern web framework for CHICKEN Scheme that lets you express HTML as data with Chiccup. Build components that compose naturally. Create powerful middleware with simple functions. Authentication in 3 lines, not 30.

🌐 Visit schematra.com for interactive examples and live demos.

Why Developers Choose Schematra

Chiccup: HTML as Data: No more template syntax headaches. Write [.card [h1 "Title"]] and get clean HTML. Map over lists, compose functions, build UIs that make sense
Zero Config Sessions: Cookie-based sessions work immediately. No setup, no database, no complexity
Functions All The Way: Middleware is just (lambda (next) ...). Routes are functions. Components are functions. Simple, composable, testable
Deploy Anywhere: Compile to a single binary. No runtime dependencies, no complex deployments

Features

Simple route definition with get, post, etc. functions
URL parameter extraction and query parameter handling
Middleware system with built-in session management
Development mode with REPL integration
Chiccup: S-expressions for HTML with syntactic sugar - your HTML structure mirrors your data structure
Built on the solid Spiffy web server

Quick Start

Installation

chicken-install schematra
# if you need chiccup, session support & oauth2:
chicken-install chiccup schematra-session oauthtoothy

Simple Web App with Chiccup

(import schematra chiccup schematra-session)

(use-middleware! (session-middleware "secret-key"))

(get ("/")
     (let ((user (session-get "username")))
       (if user
           (ccup->html `[h1 ,(format "Welcome back, ~a!" user)])
           (redirect "/login"))))

(post ("/login")
      (let ((username (alist-ref 'username (current-params))))
        (session-set! "username" username)
        (redirect "/")))

(schematra-install)
(schematra-start)

Save as app.scm, run with csi -s app.scm, and visit http://localhost:8080.

Documentation

For comprehensive documentation including:

Getting Started Guide - Installation, system requirements, and your first app
Core Concepts - Routing, parameters, and request handling
Chiccup HTML Generation - S-expressions for HTML with syntactic sugar to make writing HTML easier
API Reference - Complete function documentation
Middleware System - Composable request/response processing
Advanced Topics - Sessions, static files, and deployment
Examples & Recipes - Common patterns and use cases

Visit the full documentation.

Current Status

This is an exploration project! Schematra is in early development and not recommended for production use. It's perfect for:

Learning Scheme and web development concepts
Prototyping web applications
Experimenting with functional web programming
Understanding how web frameworks work

What's Working

✅ Routing and parameter handling
✅ Middleware system
✅ Session management
✅ Chiccup HTML generation (S-expressions with syntactic sugar)
✅ Server-Sent Events (SSE)
✅ OAuth2 authentication
✅ Development mode with REPL
✅ Static file serving

What's Coming (not in priority order)

Enhanced error handling
Database integration helpers
WebSocket support
Background job system
Production deployment guides

Contributing

Contributions welcome! See our contributing guidelines for:

Reporting bugs and requesting features
Code style and development setup
Roadmap and planned features

License

Licensed under 3-Clause BSD license.

Logo License

The Schematra logo (depicting a chicken wearing a fedora) is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).

Permitted Uses: Under the CC BY-NC 4.0 license, you are free to:

Share — copy and redistribute the logo in any medium or format
Adapt — remix, transform, and build upon the logo
Use the logo in documentation, tutorials, articles, or educational materials
Use the logo in open source projects and non-commercial applications

License Requirements: You must:

Give appropriate credit to Rolando Abarca
Provide a link to the license
Indicate if changes were made to the original logo

Restrictions: You may not:

Use the logo for commercial purposes without explicit written permission
Use the logo in any manner that suggests endorsement of commercial products or services
Remove or obscure copyright notices or license information

For commercial licensing inquiries or permission requests, please contact Rolando Abarca.

Full license text: https://creativecommons.org/licenses/by-nc/4.0/