astro.config.mjs

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

// https://astro.build/config
export default defineConfig({
	site: 'https://tidesdb.com',
	integrations: [
		starlight({
			title: 'TidesDB',
			description: 'Fast, embeddable LSM-tree based key-value storage engine library written in C. ACID transactions, great concurrency, cross-platform support.',
			customCss: [
				'./src/styles/custom.css',
			  ],
			components: {
				PageTitle: './src/components/PageTitle.astro',
			},
			logo: {
				light: './src/assets/tidesdb-logo-v8.svg',
				dark: './src/assets/tidesdb-logo-v8.svg',
				replacesTitle: true,
			},
			social: {
				youtube: 'https://www.youtube.com/@TidesDB',
				github: 'https://github.com/tidesdb/tidesdb',
				discord: 'https://discord.gg/tWEmjR66cy',
			},
			head: [
				{
					tag: 'link',
					attrs: {
						rel: 'preconnect',
						href: 'https://fonts.googleapis.com'
					}
				},
				{
					tag: 'link',
					attrs: {
						rel: 'preconnect',
						href: 'https://fonts.gstatic.com',
						crossorigin: 'anonymous'
					}
				},
				{
					tag: 'link',
					attrs: {
						href: 'https://fonts.googleapis.com/css2?family=Public+Sans:wght@300;400;500;600;700&family=Fira+Mono:wght@400;500;700&display=swap',
						rel: 'stylesheet'
					}
				},
				{
					tag: 'meta',
					attrs: {
						name: 'keywords',
						content: 'tidesdb, database, key-value store, lsm-tree, storage engine, embeddable database, c library, nosql, acid transactions, high performance database, column family, write-ahead log, bloom filter, data compression, cross-platform database, database library, key value database, fast database, embeddable storage, database engine, persistent storage, in-memory database, disk storage, concurrent database, transactional database, open source database'
					}
				},
				{
					tag: 'meta',
					attrs: {
						name: 'author',
						content: 'TidesDB Team'
					}
				},
				{
					tag: 'meta',
					attrs: {
						property: 'og:type',
						content: 'website'
					}
				},
				{
					tag: 'meta',
					attrs: {
						property: 'og:site_name',
						content: 'TidesDB'
					}
				},
				{
					tag: 'meta',
					attrs: {
						name: 'twitter:card',
						content: 'summary_large_image'
					}
				},
				{
					tag: 'link',
					attrs: {
						rel: 'canonical',
						href: 'https://tidesdb.com'
					}
				},
				{
					tag: 'meta',
					attrs: {
						name: 'robots',
						content: 'index, follow'
					}
				},
				{
					tag: 'meta',
					attrs: {
						name: 'language',
						content: 'English'
					}
				},
				{
					tag: 'meta',
					attrs: {
						name: 'revisit-after',
						content: '7 days'
					}
				},
				{
					tag: 'script',
					attrs: {
						async: true,
						src: 'https://www.googletagmanager.com/gtag/js?id=G-5P4BKM1TX3'
					}
				},
				{
					tag: 'script',
					content: `
						window.dataLayer = window.dataLayer || [];
						function gtag(){dataLayer.push(arguments);}
						gtag('js', new Date());
						gtag('config', 'G-5P4BKM1TX3');
					`
				}
			],
			sidebar: [
				{
					label: 'Getting started',
					items: [
						{ label: 'What is TidesDB?', slug: 'getting-started/what-is-tidesdb' },
						{ label: 'How does TidesDB work?', slug: 'getting-started/how-does-tidesdb-work' },
					],
				},
				{
					label: 'Reference',
					items: [
						{ label: 'Building & Benchmarking', slug: 'reference/building' },
						{ label: 'C API Reference', link: 'reference/c' },
						{ label: 'C++ API Reference', slug: 'reference/cplusplus' },
						{ label: 'C# API Reference', link: 'reference/csharp' },
						{ label: 'GO API Reference', slug: 'reference/go' },
						{ label: 'Python API Reference', slug: 'reference/python' },
						{ label: 'Java API Reference', slug: 'reference/java' },
						{ label: 'Rust API Reference', slug: 'reference/rust' },
						{ label: 'TypeScript API Reference', slug: 'reference/typescript' },
						{ label: 'Lua API Reference', slug: 'reference/lua' },
						{ label: 'TideSQL Reference', slug: 'reference/tidesql' },
						{ label: 'Kafka Reference', slug: 'reference/kafka' },
						{ label: 'Admintool Reference', slug: 'reference/admintool' },
					],
				},
				{
					label: 'Unified Manuals',
					items: [
						{
							label: 'TidesDB 9 Unified Manual',
							link: 'unified-manuals/TidesDB_9_Unified_Manual.pdf'
						},
					],
				},
				{
					label: 'Articles',
					items: [
						{
							label: 'Benchmark Analysis on TideSQL v4.3.0 in MariaDB v11.8.6 TPC-C with jemalloc and PGO',
							link: 'articles/benchmark-analysis-tidesql-v4-3-0-mariadb-v11-8-6-tpc-c-pgo-jemalloc'
						},
						{
							label: 'Profile-Guided Optimization (PGO) Build TPC-C Analysis for TideSQL in MariaDB v11.8.6',
							link: 'articles/pgo-build-tpc-c-analysis-mariadb-v11-8-6-tidesql'
						},
						{
							label: 'TPC-C Analysis with glibc, jemalloc, mimalloc, tcmalloc on TideSQL & InnoDB in MariaDB v11.8.6',
							link: 'articles/tpcc-analysis-jemalloc-mimalloc-tcmalloc-tidesql-and-innodb-in-mariadb-v11-8-6'
						},
						{
							label: 'MariaDB 11.8.6 with TidesDB(TideSQL v4.2.4) TPC-C Benchmark Analysis',
							link: 'articles/mariadb-11-8-6-innodb-and-tidesql-v4-2-4-tpc-c-benchmark-analysis'
						},
						{
							label: 'Benchmark Analysis on TidesDB v9.8.0 and RocksDB v11.0.4',
							link: 'articles/benchmark-analysis-tidesdb-v9-8-0-rocksdb-v11-0-4'
						},
						{
							label: 'Deploying TideSQL on AWS Kubernetes with S3 Object Store (Cloud-Native MariaDB)',
							link: 'articles/deploying-tidesql-on-kubernetes-with-s3-object-store-cloud-native-mariadb-aws'
						},
						{
							label: 'Deploying TideSQL (TidesDB+MariaDB) on AWS EC2',
							link: 'articles/deploying-tidesb-and-mariadb-on-ubuntu-ec2'
						},
						{
							label: 'TPC-C Benchmark Analysis on TidesDB v9.0.2 in TideSQL v4.2.0 in MariaDB v11.8.6',
							link: 'articles/tidesql-v4-2-0-tidesdb-v9-0-2-mariadb-11-8-6-tpcc-benchmark-analysis'
						},
						{
							label: 'TideSQL v4.2.0 Full-Text Search, Vector Similarity, Spatial Queries, and Cloud-Native Capabilities',
							link: 'articles/tidesql-v4-2-0-fts-vector-spatial-cloud-native-capabilities'
						},
						{
							label: 'Benchmark Analysis on TidesDB 9 (TideSQL 4.1), MyRocks, InnoDB in MariaDB 11.8.6 TPC-C HammerDB',
							link: 'articles/benchmark-analysis-tidesdb-9-rocksdb-innodb-mariadb-11-8-tpc-c-hammerdb'
						},
						{
							label: 'Benchmark Analysis on TidesDB & RocksDB in MariaDB 11.8.6 TPC-C',
							link: 'articles/tidesql-myrocks-mariadb-11-8-6-tpc-c-analysis'
						},
						{
							label: 'TidesDB (TideSQL 4) & RocksDB in MariaDB 12.2.2 Sysbench Analysis',
							link: 'articles/tidesql-myrocks-mariadb-12-2-2-sysbench-analysis'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.9.0 & RocksDB v11.0.3',
							link: 'articles/benchmark-analysis-tidesdb-v8-9-0-rocksdb-v11-0-3'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.7.1 & RocksDB v11.0.3',
							link: 'articles/benchmark-analysis-tidesdb-v8-7-1-rocksdb-11-0-3'
						},
						{
							label: 'Benchmark Analysis on TidesDB (TideSQL v3.3.5) & InnoDB in MariaDB v12.2.2 & InnoDB in MySQL v9.5.0',
							link: 'articles/benchmark-analysis-tidesql-v3-3-5-innodb-in-mariadb-v12-2-2-mysql-v9-5-0'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.6.0 & RocksDB v10.10.1',
							link: 'articles/benchmark-analysis-tidesdb-v8-6-0-rocksdb-v10-10-1'
						},
						{
							label: 'Benchmark Analysis on TidesDB (TideSQL v3.1.0) & InnoDB in MariaDB v12.2.2',
							link: 'articles/benchmark-analysis-tidesql-v3-1-0-innodb-mariadb-12-2-2'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.5.0 & RocksDB v10.10.1',
							link: 'articles/benchmark-analysis-tidesdb-v8-5-0-rocksdb-v10-10-1'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.4.0 & RocksDB v10.10.1',
							link: 'articles/benchmark-analysis-tidesdb-v8-4-0-rocksdb-v10-10-1'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.3.2 & RocksDB v10.10.1',
							link: 'articles/benchmark-analysis-tidesdb-v8-3-2-rocksdb-v10-10-1'
						},
						{
							label: 'New Benchmark Environment',
							link: 'articles/new-benchmark-environment'
						},
						{
							label: 'Benchmark Analysis on TideSQL v3 & InnoDB within MariaDB v12.1.2',
							link: 'articles/tidesql-3-innodb-mariadb-12-1-2'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.2.4 & RocksDB v10.10.1',
							link: 'articles/benchmark-analysis-tidesdb-v8-2-4-rocksdb-v10-10-1'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.2.1 & RocksDB v10.10.1',
							link: 'articles/benchmark-analysis-tidesdb-v8-2-1-rocksdb-v10-10-1'
						},
						{
							label: 'Plugging into MariaDB',
							link: 'articles/plugging-into-mariadb'
						},
						{
							label: 'Large Amount of Column Families with RocksDB and TidesDB',
							link: 'articles/rocksdb-tidesdb-large-amount-column-families'
						},
						{
							label: 'Benchmark Analysis on TidesDB v8.1.1, RocksDB v10.10.1, and LMDB v0.9.24',
							link: 'articles/benchmark-analysis-tidesdb-v8-1-1-rocksdb-v10-10-1-lmdb-v0-9-24'
						},
						{
							label: 'Benchmark Analysis on TidesDB v1.1.0 & InnoDB in MariaDB 12.1',
							link: 'articles/tidesql-v1-1-0-and-innodb-in-mariadb-12-1-benchmark-analysis'
						},
						{
							label: 'Benchmark Analysis on TidesDB 8 (Optional LSM-B+)',
							link: 'articles/tidesdb-8-optional-lsmb'
						},
						{
							label: 'Benchmark Analysis on TidesDB (TideSQL v1.0.0) & InnoDB within MariaDB v12.1.2',
							link: 'articles/benchmark-analysis-tidesql-v1-0-0-innodb-in-mariadb-v12-1-2'
						},
						{
							label: 'Benchmark Analysis on TidesDB v7.4.4 & RocksDB v10.9.1',
							link: 'articles/benchmark-analysis-tidesdb-v7-4-4-rocksdb-v10-9-1'
						},
						{
							label: 'Benchmark Analysis on TidesDB v7.4.3 & RocksDB v10.9.1',
							link: 'articles/benchmark-analysis-tidesdb-v7-4-3-rocksdb-v10-9-1'
						},
						{
							label: 'TidesDB vs InnoDB within MariaDB',
							link: 'articles/tidesdb-vs-innodb-within-mariadb'
						},
						{
							label: 'TidesDB Differences with glibc, mimalloc, tcmalloc',
							link: 'articles/tidesdb-differences-with-glibc-mimalloc-tcmalloc'
						},
						{ 
							label: 'Building Reliable and Safe Systems', 
							link: 'articles/building-reliable-and-safe-systems' 
						},
						{ 
							label: 'TidesDB for Kafka Streams - Drop-in RocksDB Replacement', 
							link: 'articles/tidesdb-kafka-streams-plugin' 
						},
						{ 
							label: 'TidesDB & RocksDB on NVMe and SSD', 
							link: 'articles/tidesdb-and-rocksdb-on-nvme-and-ssd' 
						},
						{ 
							label: 'Benchmark Analysis on TidesDB v7.4.0(mimalloc) & RocksDB v10.9.1 (jemalloc)', 
							link: 'articles/benchmark-analysis-tidesdb-v7-4-0-mimalloc-rocksdb-v10-9-1-jemalloc' 
						},
						{ 
							label: 'TideSQL - A Write and Space Optimized MySQL Fork', 
							link: 'articles/tidesql-a-write-and-space-optimized-mysql-fork' 
						},
						{ 
							label: 'TidesDB v7.3.1 vs RocksDB v10.9.1 Performance Benchmark', 
							link: 'articles/tidesdb-7-3-1-vs-rocksdb-10-9-1-benchmark' 
						},
						{ label: 'TidesDB v7.3.0 & RocksDB v10.9.1 Benchmark Analysis', slug: 'articles/benchmark-analysis-tidesdb-v7-3-0-rocksdb-v10-9-1' },
						{ label: 'From Building Houses to Storage Engines', slug: 'articles/from-building-houses-to-storage-engines' },
						{ label: 'TidesDB v7.2.3 & RocksDB v10.9.1 Benchmark Analysis', slug: 'articles/benchmark-analysis-tidesdb-v7-2-3-rocksdb-v10-9-1' },
						{ label: 'TidesDB 7.2.2 and RocksDB 10.9.1 Latency Analysis', slug: 'articles/tidesdb-722-rocksdb-1091-latency-analysis' },
						{ label: 'Analysis of TidesDB 7.2.1 and RocksDB 10.9.1', slug: 'articles/analysis-tidesdb721-rocksdb1091' },
						{ label: 'Administering TidesDB with Admintool', slug: 'articles/administering-tidesdb-with-admintool' },
						{ label: 'TidesDB 7.1.1 vs RocksDB 10.9.1', slug: 'articles/benchmark-analysis-tidesdb-v7-1-1-rocksdb-10-9-1' },
						{ label: 'Why We Benchmark on Modest Hardware?', slug: 'articles/why-bench-on-modest-hardware' },
						{ label: 'TidesDB 7 vs RocksDB 10 Under Sync Mode', slug: 'articles/benchmark-analysis-tidesdb-v7-1-0-rocksdb-v10-7-5-full-sync' },
						{ label: '1GB Value Observations TidesDB 7 & RocksDB 10', slug: 'articles/1gb-values-rocksdb10-tidesdb7' },
						{ label: 'Comparative Analysis of TidesDB v7.0.7 & RocksDB v10.7.5', slug: 'articles/benchmark-analysis-tidesdb-v7-0-7-rocksdb-v10-7-5' },
						{ label: 'Using TidesDB with Java via JExtract', slug: 'articles/using-tidesdb-with-java-via-jextract' },
						{ label: 'Death by a Thousand Cycles - Micro-Optimizations in TidesDB v7.0.4', slug: 'articles/tidesdb704-death-by-a-thousand-cycles' },
						{ label: 'What I Learned Building a Storage Engine That Outperforms RocksDB', slug: 'articles/what-i-learned-building-a-storage-engine-that-outperforms-rocksdb' },
						{ label: 'TidesDB 7 - RocksDB 10.7.5', slug: 'articles/benchmark-analysis-tidesdb7-rocksdb1075' },
						{ label: 'Seek and Range Query Performance · TidesDB v6.1.0 vs RocksDB v10.7.5', slug: 'articles/benchmark-design-range-seek-tidesdb610-rocksdb1075' },
						{ label: 'Design Decisions and Performance Analysis of TidesDB v6.0.1 & RocksDB v10.7.5', slug: 'articles/benchmark-design-analysis-tidesdb601-rocksdb1075' },
						{ label: 'Comparative Analysis of TidesDB v6 & RocksDB v10.7.5', slug: 'articles/benchmark-analysis-tidesdb6-rocksdb1075' },
						{ label: 'TidesDB 4 vs RocksDB 10 Performance Analysis', slug: 'articles/tidesdb4-vs-rocksdb10' },
					],
				},
				{
					label: 'YouTube',
					link: 'https://www.youtube.com/@TidesDB',
				},
				{
					label: 'GitHub', link: 'https://github.com/tidesdb',
				},
				{
					label: 'Discord Community', link: 'https://discord.gg/tWEmjR66cy',
				},
				{
					label: 'Sponsors', link: 'https://tidesdb.com/sponsors'
				},
				{
					label: 'Licensing', link: '/licensing'
				},
				{
					label: 'Partners', link: '/partners'
				},
				{
					label: 'Support', link: '/support'
				}
			],
		}),
	],
});