> For the complete documentation index, see [llms.txt](https://bubble.citizendev.io/bubble-convention/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bubble.citizendev.io/bubble-convention/introduction.md).

# Introduction

Bubble Convention is an open-source, free-to-use, community-based convention document for Bubble developers to use as a guide all over the world!

Bubble Convention is created by CitizenDev and other partners, maintained by the community. More information can be found in the nested documents.

1. **Naming conventions** provides ways that you can (and should) name your application constituents.
2. **Usage recommendations** provides some practices that you can structure your Bubble application, including but not limited to layout, styling, states and comments.
3. **Miscellaneous** contains some metadata, as well as recommendations that we haven't found a proper way to categorize.

If you are new here, you might wanna start with the documents below. Happy Bubbling!

{% content-ref url="/pages/ihMquVIrr0s7SZOYjaIx" %}
[About Bubble Convention document](/bubble-convention/introduction/about-bubble-convention-document.md)
{% endcontent-ref %}

{% content-ref url="/pages/Dggznz5g9aTdrMPPbAo2" %}
[About CitizenDev](/bubble-convention/introduction/about-citizendev.md)
{% endcontent-ref %}
