Refactor docs and landing to platform/library split

Reorganized documentation to distinguish between Evolu as a TypeScript library and as a local-first platform. Updated navigation, landing page, and metadata to reflect this split. Added new docs entry points, removed unused components, and adjusted redirects and features for clarity.

Author: steida

README.md

@@ -1,6 +1,6 @@
 # Evolu
 
-Evolu is TypeScript library and local-first framework.
+Evolu is TypeScript library and local-first platform.
 
 ## Documentation
 

apps/web/next.config.mjs

@@ -22,25 +22,24 @@ const nextConfig = {
   async redirects() {
     return [
       {
-        source: "/docs",
-        destination: "/docs/quickstart",
+        source: "/docs/quickstart",
+        destination: "/docs/local-first",
         permanent: true,
       },
-    ];
-  },
-  async rewrites() {
-    return [
       {
         source: "/docs/installation",
-        destination: "/docs/quickstart",
+        destination: "/docs/local-first",
+        permanent: true,
       },
       {
         source: "/docs/evolu-server",
         destination: "/docs/evolu-relay",
+        permanent: true,
       },
       {
-        source: "/examples/:path",
+        source: "/examples/:path*",
         destination: "/docs/examples",
+        permanent: true,
       },
     ];
   },

apps/web/src/app/(docs)/docs/comparison/page.mdx

@@ -1,12 +1,12 @@
 export const metadata = {
   title: "Comparison",
   description:
-    "A comparison of Evolu with other local-first frameworks and solutions, exploring their trade-offs and use cases.",
+    "A comparison of Evolu with other local-first platforms and solutions, exploring their trade-offs and use cases.",
 };
 
 # Comparison
 
-This page compares Evolu with other local-first frameworks and solutions to help you make an informed decision about which tool best fits your needs.
+This page compares Evolu with other local-first platforms and solutions to help you make an informed decision about which tool best fits your needs.
 
 The goal of Evolu is to be as simple, stable, and private as possible. It uses SQLite because SQL is a must for business apps, providing the query flexibility and reliability that production applications require.
 

apps/web/src/app/(docs)/docs/library/page.mdx

@@ -0,0 +1,26 @@
+import { IconBrandNpm } from "@tabler/icons-react";
+
+export const metadata = {
+  title: "Get started with the library",
+};
+
+# Get started with the library
+
+This guide will get you up and running with Evolu Library.
+
+<Announcement>
+  The new version of Evolu is now available on
+  <span className="font-black">npm</span> under the
+  <span className="font-black">preview</span> tag. 🎉
+</Announcement>
+
+<Note>
+  Requirements: `TypeScript 5.7` or later with the `strict` flag enabled in
+  `tsconfig.json` file.
+</Note>
+
+## Installation
+
+```bash
+npm install @evolu/common@preview
+```

…/src/app/(docs)/docs/quickstart/page.mdx …src/app/(docs)/docs/local-first/page.mdxapps/web/src/app/(docs)/docs/quickstart/page.mdx renamed to apps/web/src/app/(docs)/docs/local-first/page.mdx apps/web/src/app/(docs)/docs/quickstart/page.mdx renamed to apps/web/src/app/(docs)/docs/local-first/page.mdx

@@ -1,11 +1,10 @@
 import { IconBrandNpm } from "@tabler/icons-react";
 
 export const metadata = {
-  title: "Quickstart",
-  description: "This guide will get you all set up and ready to use Evolu.",
+  title: "Get started with local-first",
 };
 
-# Quickstart
+# Get started with local-first
 
 This guide will get you all set up and ready to use Evolu.
 

apps/web/src/app/(docs)/docs/page.mdx

@@ -0,0 +1,21 @@
+export const metadata = {
+  title: "Documentation",
+  description:
+    "Learn how to use Evolu, whether you're building with the library or the local-first platform.",
+};
+
+# Documentation
+
+Evolu is both a **TypeScript library** and a **local-first platform**. Choose your path below.
+
+## TypeScript library
+
+For anyone who wants to write TypeScript code that scales. Built on proven design patterns like Result, dependency injection, immutability, and more. Created by someone who spent years with functional programming, but then decided to go back to the simple and idiomatic TypeScript code—no pipes, no black-box abstractions, no unreadable stacktraces.
+
+[**Get started with the library** →](/docs/library)
+
+## Local-first platform
+
+A complete platform for building apps where users own their data. Works offline-first with sync via self-hostable or cloud relays. End-to-end encrypted by default. Built on SQLite with a scalable sync protocol designed for real-world use. No vendor lock-in, no data hostage situations.
+
+[**Get started with local-first** →](/docs/local-first)

apps/web/src/app/(docs)/layout.tsx

@@ -10,8 +10,7 @@ import "@/styles/tailwind.css";
 export const metadata: Metadata = {
   title: {
     template: "%s - Evolu",
-    default:
-      "Local-First Platform Designed for Privacy, Ease of Use, and No Vendor Lock-In",
+    default: "TypeScript Library and Local-First Platform",
   },
 };
 

apps/web/src/app/(landing)/layout.tsx

@@ -3,14 +3,12 @@ import { type Metadata } from "next";
 import { Providers } from "@/app/providers";
 import { Footer } from "@/components/Footer";
 import { Header } from "@/components/Header";
-import LetterGlitch from "@/components/LetterGlitch";
 import "@/styles/tailwind.css";
 
 export const metadata: Metadata = {
   title: {
     template: "%s - Evolu",
-    default:
-      "Local-First Platform Designed for Privacy, Ease of Use, and No Vendor Lock-In",
+    default: "TypeScript Library and Local-First Platform",
   },
 };
 
@@ -21,13 +19,6 @@ export default function RootLayout({
 }): React.ReactElement {
   return (
     <Providers>
-      <LetterGlitch
-        className="pointer-events-none fixed! inset-0 z-[-1] hidden transform-gpu opacity-[0.13] transition-opacity duration-300 sm:block dark:opacity-[0.05]"
-        glitchSpeed={50}
-        centerVignette={false}
-        outerVignette={true}
-        smooth={true}
-      />
       <div className="mx-auto h-full max-w-5xl">
         <Header variant="landing" />
 

apps/web/src/app/(landing)/page.tsx

@@ -1,31 +1,32 @@
 import { Button } from "@/components/Button";
 import { Features } from "@/components/Features";
-import { Guides } from "@/components/Guides";
-import { HeroText } from "@/components/HeroText";
 import { Logo } from "@/components/Logo";
-export const metadata = {
+import { Metadata } from "next";
+
+export const metadata: Metadata = {
   title: "Evolu",
-  description: "Privacy-focused local-first platform that scales.",
+  description: "TypeScript Library and Local-First Platform",
 };
 
 export default function Page(): React.ReactElement {
   return (
     <>
       <div className="flex flex-col gap-4 pt-14 xl:mx-auto xl:max-w-5xl">
         <Logo className="mx-auto h-9" />
-        <HeroText className="text-center" />
+        <p className="lead w-full text-center text-balance">
+          TypeScript Library and Local&#8209;First Platform
+        </p>
         <div className="flex justify-center gap-5">
           <Button
-            href="/docs/quickstart"
+            href="/docs"
             arrow="right"
             className="scale-105 hover:scale-110"
           >
-            Quickstart
+            Get started
           </Button>
         </div>
 
         <Features />
-        <Guides className="mt-10!" />
       </div>
     </>
   );

apps/web/src/app/layout.tsx

@@ -3,8 +3,7 @@ import { type Metadata } from "next";
 export const metadata: Metadata = {
   title: {
     template: "%s - Evolu",
-    default:
-      "Local-First Platform Designed for Privacy, Ease of Use, and No Vendor Lock-In",
+    default: "TypeScript Library and Local-First Platform",
   },
   alternates: {
     types: {