3ae48af67c
This PR starts putting in place the high-level changes we want to make to the docs site. - It makes separate sections for Reference and Examples and Community. - Gets rid of the secondary sidebar and integrates it into the main sidebar. - Groups the reference articles by type. - Pulls in the examples alongside code and a live playground so people don't have to visit examples.tldraw.com separately. <img width="1458" alt="Screenshot 2024-01-30 at 09 43 46" src="https://github.com/tldraw/tldraw/assets/469604/4f5aa339-3a69-4d9b-9b9f-dfdddea623e8"> Again, this is the top-level changes and there's more to be done for the next PR(s): - create quick start page - clean up installation page - add accordion to Examples page prbly - put fun stuff in header (from footer) - landing page - something for landing page of API - search cmd-k and border - cleanup _sidebarReferenceContentLinks - external links _blank - address potential skew issue with code examples - have a link to other examples (next.js, etc.) ### Change Type - [x] `documentation` — Changes to the documentation only[^2] ### Test Plan 1. Make sure examples work! ### Release Notes - Rework our docs site to pull together the examples app and reference section more cohesively. --------- Co-authored-by: Taha <98838967+Taha-Hassan-Git@users.noreply.github.com> Co-authored-by: Steve Ruiz <steveruizok@gmail.com> Co-authored-by: Mitja Bezenšek <mitja.bezensek@gmail.com> Co-authored-by: alex <alex@dytry.ch> Co-authored-by: Lu Wilson <l2wilson94@gmail.com> Co-authored-by: Dan Groshev <git@dgroshev.com>
52 lines
1.2 KiB
TypeScript
52 lines
1.2 KiB
TypeScript
'use client'
|
|
|
|
import { SandpackCodeEditor, SandpackFiles, SandpackProvider } from '@codesandbox/sandpack-react'
|
|
import { useTheme } from 'next-themes'
|
|
import { useEffect, useState } from 'react'
|
|
|
|
export default function ExampleCodeBlock({
|
|
articleId,
|
|
files = {},
|
|
activeFile,
|
|
}: {
|
|
articleId: string
|
|
activeFile: string
|
|
files: SandpackFiles
|
|
}) {
|
|
const [isClientSide, setIsClientSide] = useState(false)
|
|
const { theme } = useTheme()
|
|
useEffect(() => setIsClientSide(true), [])
|
|
const SERVER =
|
|
process.env.NODE_ENV === 'development' ? 'http://localhost:5420' : 'https://examples.tldraw.com'
|
|
|
|
// This is to avoid hydration mismatch between the server and the client because of the useTheme.
|
|
if (!isClientSide) {
|
|
return null
|
|
}
|
|
|
|
return (
|
|
<>
|
|
<iframe
|
|
src={`${SERVER}/${articleId}/full`}
|
|
style={{ border: 0, height: '50vh', width: '100%' }}
|
|
/>
|
|
<SandpackProvider
|
|
key={`sandpack-${theme}-${activeFile}`}
|
|
template="react-ts"
|
|
options={{ activeFile }}
|
|
customSetup={{
|
|
dependencies: {
|
|
'@tldraw/assets': 'latest',
|
|
'@tldraw/tldraw': 'latest',
|
|
},
|
|
}}
|
|
files={{
|
|
...files,
|
|
}}
|
|
theme={theme === 'dark' ? 'dark' : 'light'}
|
|
>
|
|
<SandpackCodeEditor readOnly />
|
|
</SandpackProvider>
|
|
</>
|
|
)
|
|
}
|