Skip to content

Instantly share code, notes, and snippets.

@pydanny

pydanny/roadmap.md

Last active August 30, 2025 10:54
Show Gist options
  • Save pydanny/79a482d0cce1b3c4b9de8615a17c516a to your computer and use it in GitHub Desktop.
Save pydanny/79a482d0cce1b3c4b9de8615a17c516a to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. pydanny revised this gist Aug 30, 2025. 1 changed file with 5 additions and 3 deletions.
    8 changes: 5 additions & 3 deletions roadmap.md
    View file
    Original file line number Diff line number Diff line change
    @@ -12,11 +12,13 @@ Through our own experiences and feedback from users we can say the following is

    Yet we've got a ways to go before I feel confident about taking Air from Alpha to Beta. It's not just a matter of stability, it is also features that I believe are core to the vision. I want the project to be easier and more powerful for app builders and end users alive.

    ## GOAL & TIMELINE
    ## Timeline to Beta

    TLDR: Move to Beta soon
    TLDR: When we feel Air is ready

    TODO: expand
    While it would be nice to have Air be a Beta project there's something to be said about having the freedom to make breaking changes or to backtrack from designs when we must. It's easy to fix mistakes now then later when there are more projects that could be broken by us making breaking changes. By staying in alpha longer it gives us the opportunity to validate our ideas .

    To summarize by staying in alpha longer allows us to undo mistakes rather than being stuck with them forever

    ## GOALS

  2. pydanny revised this gist Aug 30, 2025. No changes.
  3. pydanny revised this gist Aug 30, 2025. 1 changed file with 7 additions and 12 deletions.
    19 changes: 7 additions & 12 deletions roadmap.md
    View file
    Original file line number Diff line number Diff line change
    @@ -1,25 +1,20 @@
    I'm really proud of what we've accomplished with Air. In a few short months we've taken a sketch of an idea and built out a new web framework that is both new and exciting, yet able to plug effortlessly into the FastAPI ecosystem.
    # ROADMAP

    Yet we've got a ways to go before we feel confident about taking Air from Alpha to Beta. It's not just a matter of stability, it is also features that I believe are core to the vision.
    I'm really proud of what we've accomplished with Air. In a few short months we've taken a sketch of an idea and built out a new web framework that is both new and exciting, yet able to plug effortlessly into the FastAPI ecosystem.

    Through our own experiences and feedback from users we can say the following is working out quite well.
    Through our own experiences and feedback from users we can say the following is working out quite well:

    - **Air Tags** are really popular and most people enjoy the API. That it plugs so well into IDEs and LLMs is a super power.
    - **AirResponse** makes writing views powered by Jinja or Air Tags easy and fast
    - **Examples** in all the doc strings makes it much easier for both humans and LLMs
    - Jinja base templates + Air Tags for content are a superpower
    - Leaning into FastAPI-isms means its easy to plug into that ecosyste,
    - **Jinja + Air Tags** base templates for layout and Air Tags for content is a really sweet pattern we should talk about more
    - **Ecosystem** Leaning into FastAPI-isms means its easy to plug into the large and vibrant FastAPI ecosystem. Deployment is also easy - Air deploys precisely the same way as FastAPI

    Yet we've got a ways to go before I feel confident about taking Air from Alpha to Beta. It's not just a matter of stability, it is also features that I believe are core to the vision. I want the project to be easier and more powerful for app builders and end users alive.

    ## GOAL & TIMELINE

    TLDR: Move to Beta by X date



    ## MOTIVATION

    TLDR: Make it easier for us and other builders
    TLDR: Move to Beta soon

    TODO: expand

  4. pydanny created this gist Aug 30, 2025.
    46 changes: 46 additions & 0 deletions roadmap.md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,46 @@
    I'm really proud of what we've accomplished with Air. In a few short months we've taken a sketch of an idea and built out a new web framework that is both new and exciting, yet able to plug effortlessly into the FastAPI ecosystem.

    Yet we've got a ways to go before we feel confident about taking Air from Alpha to Beta. It's not just a matter of stability, it is also features that I believe are core to the vision.

    Through our own experiences and feedback from users we can say the following is working out quite well.

    - **Air Tags** are really popular and most people enjoy the API. That it plugs so well into IDEs and LLMs is a super power.
    - **AirResponse** makes writing views powered by Jinja or Air Tags easy and fast
    - **Examples** in all the doc strings makes it much easier for both humans and LLMs
    - Jinja base templates + Air Tags for content are a superpower
    - Leaning into FastAPI-isms means its easy to plug into that ecosyste,


    ## GOAL & TIMELINE

    TLDR: Move to Beta by X date



    ## MOTIVATION

    TLDR: Make it easier for us and other builders

    TODO: expand

    ## GOALS

    TODO: Make sure all this has tickets, and link to it. Also include reasoning

    - Finished User & Auth & login design
    - AirRouter (compositing multiple Air apps together while preserving middleware and app info)
    - Accessibility (Section 508, light/dark modes, fonts, etc) - suggested by @tallerasaf
    - Better database support (optional install) - suggested by @audreyfeldroy
    - Vastly improved Forms
    - CSRF
    - field includes
    - Improved error handling
    - Jinja templates from within AirTags
    - Docs:
    - Bring AirMarkdown back into core as an optional install so it can move faster
    - Every callable has a code example
    - Code highlighting in AirDocs
    - Code copying in AirDocs
    - Automate deployment of AirDocs