KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #deepseek-harness #windows #open-source #agent-skills #ai

utopian

★ 99 Open GitHub ↗

A web framework for Common Lisp never finished.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Utopian

[![Quicklisp dist](http://quickdocs.org/badge/utopian.svg)](http://quickdocs.org/utopian/)

> The caveman in offering the first garland to his maiden thereby transcended the brute. He became a utopian in thus rising above the crude necessities of nature. He entered the realm of art when he perceived the subtle use of the useless.
> -- Okakura Tenshin, "The Book of Tea"

3 steps to write a better web application:

1. Choose the right language.
2. Choose the right web framework.
3. Write less.

Utopian is a web application framework that encourages rapid web development.

## Requirements

* [Roswell](https://github.com/roswell/roswell)
* [Qlot](https://github.com/fukamachi/qlot)
* An RDBMS you like one of SQLite3, MySQL or PostgreSQL.

## Getting started

### Installation

```
$ ros install fukamachi/utopian
$ ros install fukamachi/lsx
$ ros install fukamachi/qlot
```

Ensure `~/.roswell/bin` is in your shell `$PATH`.

### Creating a new project

To generate the project skeleton, open a terminal and execute this command:

```
$ utopian new blog
```

### Installing dependencies

```
$ cd blog/
$ qlot install
```

### Database Settings

This section is needed only when using MySQL or PostgreSQL.

#### Creating a database user

##### PostgreSQL

```
$ createuser -d blog
```

##### MySQL

```
$ mysql -u root
mysql> CREATE USER blog@localhost IDENTIFIED BY '';
mysql> GRANT ALL ON *.* TO blog@localhost;
```

#### Creating a database

```
$ .qlot/bin/utopian db create
```

### Starting a development server

```
$ .qlot/bin/utopian server
Hunchentoot server is going to start.
Listening on localhost:5000.
```

## DB Migration

Add Mito table classes under `models/` directory and run the following commands:

```
$ .qlot/bin/utopian generate migration
$ .qlot/bin/utopian db migrate
```

## Examples

See [examples/](https://github.com/fukamachi/utopian/tree/next/examples) directory.

## See Also

- [Clack](https://github.com/fukamachi/clack) / [Lack](https://github.com/fukamachi/lack)
- [MyWay](https://github.com/fukamachi/myway): Sinatra-compatible router.
- [Mito](https://github.com/fukamachi/mito): An O/R Mapper with schema versioning.
- [LSX](https://github.com/fukamachi/lsx): Embeddable HTML Templating engine.

## Author

Eitaro Fukamachi (e.arrows@gmail.com)

## Copyright

## License

Licensed under the LLGPL License.

utopian

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README