sbt-microsites

An sbt plugin to create awesome microsites for your project

Want a Jekyll website built?

Demo Download

sbt-microsites

sbt-microsites is an SBT plugin that facilitates the creation of fancy microsites for your projects, with minimal tweaks.

What is a microsite?

A microsite is an instance of Jekyll, ready to publish a static web page for your new library. Some of the benefits of having these auto-generated web pages are:

You can write documentation easily in markdown format.
Templates, layouts, styles, and other resources will be available through the plugin at compile time.
You don't have to deal with the styling.

Installation

To begin, add the following lines to the project/plugins.sbt file within your project or sbt module where you want to use the sbt-microsites plugin.

addSbtPlugin("com.47deg"  % "sbt-microsites" % "1.4.4")

Finally, to enable the plugin, add this to your build.sbt file:

enablePlugins(MicrositesPlugin)

We recommend taking a look at the Getting Started section in the documentation since there are some prerequisites that are needed to build your microsite.

Documentation

Microsites comes with a range of options to customize and configure your project's site. Please visit the documentation section for more information.

sbt-microsites in the wild

Many Scala projects, libraries, and applications use sbt-microsites to display documentation and project notes. If you wish to add your library here, please consider a PR to include it in the list below.

★	★	★
	Cats	A library of typeclasses for functional programming, such as functors, monads, and arrows.
	Scalaz	A library of typeclasses for functional programming, such as functors, monads, and arrows.
	Cats-Effect	Extension of Cats for general effect types, with asynchronicity and concurrency
	fs2	Functional Streams for Scala (FS2), based on `cats` and `cats-effect`
	pureconfig	A library for loading configuration files
	ciris	A configuration as code library for compile-time safe configurations
	Tuco	Tuco is a reasonable telnet server for Scala
	Atto	Everyday parsers.
	Typelevel Scala	Our fork of the Scala compiler
	Monocle	Optics library for Scala
	ScalaCache	A facade for popular cache implementations, such as Caffeine, Redis, or Memcached
	scalacheck-toolbox	Generating sensible data with ScalaCheck
	Algebird	Algebraic typeclasses and data structures for big data
	Scalding	Scala API for Hadoop and Cascading
	Finch	A combinator API over the Finagle HTTP services
	fetch	Simple & Efficient data access for Scala and Scala.js
	github4s	A GitHub API wrapper written in Scala
	hammock	A purely functional HTTP client for Scala
	cron4s	A CRON expression parser and AST for Scala
	freestyle	A cohesive & pragmatic framework of FP centric Scala libraries
	libra	A dimensional analysis library based on dependent types
	Scanamo	Simpler DynamoDB access for Scala
	Mocked Streams	Scala DSL for Unit-Testing Kafka Streams Topologies
	sbt-kubeyml	Typesafe Kubernetes manifests to deploy Scala applications