Skip to content

Commit c28c47e

Browse files
committed
docs: add features and architecture pages
1 parent 48132ab commit c28c47e

File tree

10 files changed

+106
-204
lines changed

10 files changed

+106
-204
lines changed
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: GibsonAI features
3+
subtitle: Explore GibsonAI's features
4+
enableTableOfContents: true
5+
updatedOn: '2025-06-17T00:37:35.166Z'
6+
---
7+
8+
## AI-Powered Schema Design and Data Modeling
9+
10+
GibsonAI lets you create and modify database schemas using natural language. Simply describe your needs, and it generates executable SQL, Python models, and Pydantic schemas instantly from scratch or from existing schemas.
11+
12+
## Instant ERD (Entity-Relationship Diagram) Generation
13+
14+
As you build or change schemas, GibsonAI generates live ERDs so you can visualize table relationships and structures.
15+
16+
## Zero-Downtime Migrations
17+
18+
GibsonAI supports seamless schema migrations. You can evolve your data model in production without interruptions, updating the schema live.
19+
20+
## Fully Deployed APIs Out of the Box
21+
22+
For each new schema, GibsonAI automatically provides CRUD endpoints and comprehensive API documentation, including pagination, filtering, and sorting support.
23+
24+
## Native Natural Language to SQL
25+
26+
You can interact with your database using plain English. Ask a question and GibsonAI generates the SQL query for you to run instantly.
27+
28+
## Instant Provisioning of Cloud or On-Prem Databases
29+
30+
Deploy development and production serverless SQL instances with a single command. Instances autoscale to match your workload, only charging you for what you use.
31+
32+
## Autoscaling On Demand
33+
34+
Handling sudden traffic spikes is automatic—compute and storage adjust without intervention.
35+
36+
## AI-Driven Query Optimization
37+
38+
GibsonAI monitors query performance and offers recommendations on indexes, rewrites, or caching to improve speed.
39+
40+
## Connection Strings & Full Schema Export
41+
42+
You can retrieve production-grade connection strings and view the complete SQL schema for external use or deeper inspection.
43+
44+
## Support for Local Studio Tools
45+
46+
A dedicated "Studio" web interface (powered by Drizzle ORM) runs locally for browsing and querying your database within your browser.
47+
48+
## Deployment Environments and Database Cloning
49+
50+
GibsonAI now separates development and production environments and offers easy schema cloning via URL sharing—ideal for forking or collaborating.
51+
52+
## CLI-Based SQL Runner
53+
54+
A built-in SQL runner allows you to query databases directly from your terminal using the Gibson CLI.
55+
56+
## Continuous Updates to Schema Agent & Performance
57+
58+
Regular improvements include faster schema design, enhanced accuracy, upgraded ERD readability, and better error handling in APIs

content/docs/guides/neon-features.md

Lines changed: 0 additions & 152 deletions
This file was deleted.
Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,27 @@
11
---
2-
title: Neon architecture
3-
redirectFrom:
4-
- /docs/storage-engine/architecture-overview
5-
- /docs/conceptual-guides/architecture-overview
6-
updatedOn: '2024-11-21T16:16:13.439Z'
2+
title: GibsonAI Architecture
3+
subtitle: Understand infrastructure behind GibsonAI
4+
updatedOn: '2025-06-17T16:16:13.439Z'
75
---
86

9-
Neon architecture is based on the separation of compute and storage and is orchestrated by the Neon Control Plane, which manages cloud resources across both storage and compute.
7+
GibsonAI is built on a modern, scalable infrastructure designed to support dynamic database engineering
108

11-
A Neon compute runs Postgres, and storage is a multi-tenant key-value store for Postgres pages that is custom-built for the cloud.
9+
## Cloud-Native Architecture
1210

13-
![Neon architecture diagram](/docs/introduction/neon_architecture_5.jpg)
11+
GibsonAI runs on a robust cloud platform to ensure high availability and security.
1412

15-
Neon storage consists of three main components: Safekeepers, Pageservers, and cloud object storage.
13+
## Modular Microservices
1614

17-
Safekeepers are responsible for durability of recent updates.
18-
Postgres streams [Write-Ahead Log (WAL)](/docs/reference/glossary#wal) to the Safekeepers, and the Safekeepers store the WAL durably until it has been processed by the Pageservers and uploaded to a cloud object store.
15+
Each component (ERD generation, schema management, API deployment) is handled by specialized microservices. This makes everything faster and easier to manage or improve.
1916

20-
Pageservers are responsible for serving read requests. To do that, Pageservers process the incoming WAL stream into a custom storage format that makes all [page](/docs/reference/glossary#page) versions easily accessible. Pageservers also upload data to cloud object storage, and download the data on demand.
17+
## Containerization
2118

22-
Safekeepers can be thought of as an ultra-reliable write buffer that holds the latest data until it is processed and uploaded to cloud storage. Safekeepers implement the Paxos protocol for reliability. Pageservers also function as a read cache for cloud storage, providing fast random access to data pages.
19+
Utilizes Docker and Kubernetes for easy scaling and reliable deployments.
2320

24-
## Durability
21+
## Data Security
2522

26-
Durability is at the core of Neon's architecture. As described earlier, incoming WAL data is initially stored across multiple availability zones in a [Paxos](<https://en.wikipedia.org/wiki/Paxos_(computer_science)>) cluster before being uploaded to a cloud object store, such as [Amazon S3](https://aws.amazon.com/s3/) (99.999999999% durability), both in raw WAL and materialized form. Additional copies are maintained across Pageservers to enhance the read performance of frequently accessed data. Consequently, there are always multiple copies of your data in Neon, ensuring durability.
23+
GibsonAI takes your data seriously. It uses strong encryption to make sure no one can read your data without permission. It also controls who can access what, so only the right people can see or change things.
2724

28-
## Archive storage
25+
## Continuous Monitoring
2926

30-
Archive storage in Neon, which enables [branch archiving](/docs/guides/branch-archiving) on the Free Plan, optimizes storage resources by offloading data that's not being used. As described above, Neon’s architecture includes Safekeepers, Pageservers, and cloud object storage. In this setup, the Pageservers are responsible for processing and uploading data to cloud object storage as soon as it's written. When a branch is archived, it does not involve moving data; instead, the branch's data is simply evicted from the Pageserver, freeing up Pageserver storage. This approach ensures that while archived data is readily available on demand in cost-efficient object storage, it's no longer taking up space in the more performant storage used by Neon's Pageservers.
27+
Real-time monitoring and logging using smart monitoring tools. These tools track how well everything is working and alert the team if something goes wrong. This helps fix problems fast and keep the service running smoothly.

content/docs/sidebar.yaml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -209,11 +209,11 @@
209209
# items:
210210
# - title: Sample data
211211
# slug: import/import-sample-data
212-
# - section: Platform
213-
# items:
214-
# - title: Architecture
215-
# icon: architecture
216-
# slug: introduction/architecture-overview
212+
- section: Platform
213+
items:
214+
- title: Architecture
215+
icon: architecture
216+
slug: introduction/architecture-overview
217217
# items:
218218
# - title: Overview
219219
# slug: introduction/architecture-overview
@@ -223,9 +223,9 @@
223223
# slug: introduction/compute-lifecycle
224224
# - title: High availability
225225
# slug: introduction/high-availability
226-
# - title: Features
227-
# slug: guides/neon-features
228-
# icon: features
226+
- title: Features
227+
slug: guides/gibsonai-features
228+
icon: features
229229
# items:
230230
# - title: Serverless
231231
# slug: introduction/serverless

src/components/pages/doc/menu/icon/icon.jsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ const icons = {
107107
const Icon = ({ title, className = null }) => {
108108
const IconTag = icons[title];
109109

110-
return <IconTag className={className} />;
110+
return <IconTag className={className} style={{ color: '#c0f910' }} />;
111111
};
112112

113113
Icon.propTypes = {

src/components/pages/error/hero/hero.jsx

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,6 @@ const Hero = ({ title, text, reset }) => {
5555
>
5656
<div className="col-start-2 col-end-6 flex flex-col 2xl:col-start-1 lg:col-end-7 md:col-span-full">
5757
<h1 className="font-title text-[58px] font-medium leading-none xl:text-5xl xl:leading-none lg:text-4xl">
58-
Ooops!
5958
<br />
6059
{title}
6160
</h1>
@@ -65,7 +64,7 @@ const Hero = ({ title, text, reset }) => {
6564
</div>
6665
</div>
6766

68-
<div className="col-start-6 col-end-12 2xl:col-end-13 lg:col-start-7 md:col-span-full">
67+
{/* <div className="col-start-6 col-end-12 2xl:col-end-13 lg:col-start-7 md:col-span-full">
6968
<Image
7069
className="w-full md:mx-auto md:max-w-xl"
7170
width={860}
@@ -75,7 +74,7 @@ const Hero = ({ title, text, reset }) => {
7574
quality={75}
7675
priority
7776
/>
78-
</div>
77+
</div> */}
7978
</Container>
8079
</section>
8180
);

src/components/shared/button/button.jsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ const styles = {
1919
xxs: 'h-8 px-4 text-sm tracking-extra-tight',
2020
},
2121
theme: {
22-
primary: 'bg-primary-1 text-black hover:bg-[#00e5bf]',
22+
primary: 'bg-[#c0f910] text-black hover:bg-[#c0f910]',
2323
secondary: 'bg-black text-white hover:bg-[#292929] disabled:bg-[#292929]',
2424
tertiary: 'bg-transparent text-white border border-white hover:border-primary-2',
2525
quaternary: 'bg-white text-black border border-black hover:border-primary-2',
@@ -33,7 +33,7 @@ const styles = {
3333
'gray-dark-outline-black':
3434
'text-black border border-gray-new-90 bg-gray-new-98 hover:border-gray-new-70 dark:text-white dark:bg-gray-new-10 dark:border-[#37393D] dark:hover:border-white',
3535
'green-outline':
36-
'bg-[#0D0D0D] text-white border transition-shadow duration-500 border-green-45 hover:shadow-[0px_8px_30px_0px_rgba(0,229,153,.16)]',
36+
'bg-[#c0f910] text-white border transition-shadow duration-500 border-green-45 hover:shadow-[0px_8px_30px_0px_rgba(0,229,153,.16)]',
3737
'green-underlined':
3838
'underline decoration-green-45/40 hover:decoration-green-45/100 text-green-45 transition-colors duration-500',
3939
blue: 'bg-blue-80 text-black hover:bg-[#C6EAF1]',

src/components/shared/header/header.jsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ const Header = ({
8181
priority
8282
isHeader
8383
/>
84-
<Navigation isDarkTheme={isDarkTheme} />
84+
{/* <Navigation isDarkTheme={isDarkTheme} /> */}
8585
</div>
8686
<Sidebar isDarkTheme={isDarkTheme} isClient={isClient} />
8787
</Container>

0 commit comments

Comments
 (0)