Skip to content

imichaelnorris/birdpress

Repository files navigation

BirdPress Logo

BirdPress is a Markdown-based blogging platform that can be used as a standalone Flutter app or embedded inside of another Flutter app.

It's pretty bare-bones right now.

Example

birdpress example blog

Features

  • Write blog posts in Markdown.
  • Create blog themes in Flutter.
  • Main page for a blog

URls

BirdPress uses named routes in Flutter. The following pages have been added:

  • / The index of the site. The route can be prefixed by setting BirdPressSettings.blogPrefix, i.e. blogPrefix = "blog/".
  • /posts The list of posts or an individual post. Can be overwritten with BirdPressSettings.postsPath. If blogPrefix is specified then this is $blogPrefix/$postsPath

Getting started

BirdPress is currently under development, all APIs are subject to change before the 1.0.0 release. The documentation will be kept up-to-date to my best-effort.

Installation:

  • install the birdpress plugin.
  • update assets/birdpress/index.md if desired. If you don't want to have a header, or want it to be implemented in Flutter, override the default BirdPressSettings and set indexFile to "".
  • write blogposts in assets/birdpress/posts/
  • Check the example birdpress site in birdpress/lib/main.dart to see how to use BirdPress in an existing flutter app

Usage

BirdPress is a Flutter widget, run it as a standalone Flutter app like so:

main() {
  runApp(BirdPress());
}

Additional information

I am currently investigating the following features: [ ] Flutter-based templating for designing layouts

TODO: Tell users more about the package: where to find more information, how to contribute to the package, how to file issues, what response they can expect from the package authors, and more.

Releases

No releases published

Packages

No packages published

Languages