mirror of
https://github.com/zitadel/zitadel.git
synced 2025-08-11 21:57:32 +00:00
312b7b6010
This PR modernizes the ZITADEL monorepo build system by migrating from Yarn to pnpm, introducing Turbo for improved build orchestration, and cleaning up configuration inconsistencies across all apps and packages. ### 🎯 Key Improvements #### 📦 **Package Manager Migration (Yarn → pnpm)** - **Performance**: Faster installs with pnpm's efficient symlink-based node_modules structure - **Disk space**: Significant reduction in disk usage through content-addressable storage - **Lockfile**: More reliable dependency resolution with pnpm-lock.yaml - **Workspace support**: Better monorepo dependency management #### ⚡ **Turbo Integration** - **Build orchestration**: Dependency-aware task execution across the monorepo - **Intelligent caching**: Dramatically faster builds on CI/CD and local development - **Parallel execution**: Optimal task scheduling based on dependency graphs - **Vercel optimization**: Enhanced build performance and caching on Vercel deployments #### 🧹 **Configuration Cleanup & Unification** - **Removed config packages**: Eliminated `@zitadel/*-config` packages and inlined configurations - **Simplified dependencies**: Reduced complexity in package.json files across all apps - **Consistent tooling**: Unified prettier, ESLint, and TypeScript configurations - **Standalone support**: Improved prepare-standalone.js script for subtree deployments ### 📋 Detailed Changes #### **🔧 Build System & Dependencies** - ✅ Updated all package.json scripts to use `pnpm` instead of `yarn` - ✅ Replaced `yarn.lock` with pnpm-lock.yaml and regenerated dependencies - ✅ Added Turbo configuration (turbo.json) to root and individual packages - ✅ Configured proper dependency chains: `@zitadel/proto#generate` → `@zitadel/client#build` → `console#build` - ✅ Added missing `@bufbuild/protobuf` dependency to console app for TypeScript compilation #### **🚀 CI/CD & Workflows** - ✅ Updated all GitHub Actions workflows to use `pnpm/action-setup@v4` - ✅ Migrated build processes to use Turbo with directory-based filters (`--filter=./console`) - ✅ **New**: Added `docs.yml` workflow for building documentation locally (helpful for contributors without Vercel access) - ✅ Fixed dependency resolution issues in lint workflows - ✅ Ensured proto generation always runs before builds and linting #### **📚 Documentation & Proto Generation** - ✅ **Robust plugin management**: Enhanced plugin-download.sh with retry logic and error handling - ✅ **Vercel compatibility**: Fixed protoc-gen-connect-openapi plugin availability in Vercel builds - ✅ **API docs generation**: Resolved Docusaurus build errors with OpenAPI plugin configuration - ✅ **Type safety**: Improved TypeScript type extraction patterns in Angular components #### **🛠️ Developer Experience** - ✅ Updated all README files to reference pnpm commands - ✅ Improved Makefile targets to use Turbo for consistent builds - ✅ Enhanced standalone build process for login app subtree deployments - ✅ Added debug utilities for troubleshooting build issues #### **🗂️ File Structure & Cleanup** - ✅ Removed obsolete configuration packages and their references - ✅ Cleaned up Docker files to remove non-existent package copies - ✅ Updated workspace references and import paths - ✅ Streamlined turbo.json configurations across all packages ### 🎉 Benefits 1. **⚡ Faster Builds**: Turbo's caching and parallel execution significantly reduce build times 2. **🔄 Better Caching**: Improved cache hits on Vercel and CI/CD environments 3. **🛠️ Simplified Maintenance**: Unified tooling and configuration management 4. **📈 Developer Productivity**: Faster local development with optimized dependency resolution 5. **🚀 Enhanced CI/CD**: More reliable and faster automated builds and deployments 6. **📖 Better Documentation**: Comprehensive build documentation and troubleshooting guides ### 🧪 Testing - ✅ All apps build successfully with new pnpm + Turbo setup - ✅ Proto generation works correctly across console, login, and docs - ✅ GitHub Actions workflows pass with new configuration - ✅ Vercel deployments work with enhanced plugin management - ✅ Local development workflow verified and documented This migration sets a solid foundation for future development while maintaining backward compatibility and improving the overall developer experience. --------- Co-authored-by: Elio Bischof <elio@zitadel.com>
471 lines
14 KiB
JavaScript
471 lines
14 KiB
JavaScript
/** @type {import('@docusaurus/types').DocusaurusConfig} */
|
||
module.exports = {
|
||
title: "ZITADEL Docs",
|
||
trailingSlash: false,
|
||
url: "https://zitadel.com",
|
||
baseUrl: "/docs",
|
||
onBrokenLinks: "warn",
|
||
onBrokenAnchors: "warn",
|
||
onBrokenMarkdownLinks: "throw",
|
||
favicon: "img/favicon.ico",
|
||
organizationName: "zitadel",
|
||
projectName: "zitadel",
|
||
scripts: [
|
||
{
|
||
src: "/docs/proxy/js/script.js",
|
||
async: true,
|
||
defer: true,
|
||
"data-domain": "zitadel.com",
|
||
"data-api": "/docs/proxy/api/event",
|
||
},
|
||
],
|
||
customFields: {
|
||
description:
|
||
"Documentation for ZITADEL - Identity infrastructure, simplified for you.",
|
||
},
|
||
themeConfig: {
|
||
metadata: [
|
||
{
|
||
name: "keywords",
|
||
content:
|
||
"zitadel, documentation, jwt, saml, oauth2, authentication, serverless, login, auth, authorization, sso, openid-connect, oidc, mfa, 2fa, passkeys, fido2, docker",
|
||
},
|
||
{
|
||
property: "og:type",
|
||
content: "website",
|
||
},
|
||
{ property: "og:url", content: "https://www.zitadel.com/docs" },
|
||
{
|
||
property: "og:image",
|
||
content: "https://www.zitadel.com/docs/img/preview.png",
|
||
},
|
||
{ property: "twitter:card", content: "summary_large_image" },
|
||
{ property: "twitter:url", content: "https://www.zitadel.com/docs" },
|
||
{ property: "twitter:title", content: "ZITADEL Docs" },
|
||
{
|
||
property: "twitter:image",
|
||
content: "https://www.zitadel.com/docs/img/preview.png",
|
||
},
|
||
],
|
||
zoom: {
|
||
selector: ".markdown :not(em) > img",
|
||
background: {
|
||
light: "rgb(243, 244, 246)",
|
||
dark: "rgb(55, 59, 82)",
|
||
},
|
||
// options you can specify via https://github.com/francoischalifour/medium-zoom#usage
|
||
config: {},
|
||
},
|
||
navbar: {
|
||
// title: 'ZITADEL',
|
||
logo: {
|
||
alt: "ZITADEL logo",
|
||
src: "img/zitadel-logo-dark.svg",
|
||
srcDark: "img/zitadel-logo-light.svg",
|
||
href: "https://zitadel.com",
|
||
target: "_blank",
|
||
},
|
||
items: [
|
||
{
|
||
type: "doc",
|
||
label: "🚀 Quick Start",
|
||
docId: "guides/start/quickstart",
|
||
position: "left",
|
||
},
|
||
{
|
||
type: "doc",
|
||
label: "Documentation",
|
||
docId: "guides/overview",
|
||
position: "left",
|
||
},
|
||
{
|
||
type: "doc",
|
||
label: "APIs",
|
||
docId: "apis/introduction",
|
||
position: "left",
|
||
},
|
||
{
|
||
type: "doc",
|
||
label: "Self-Hosting",
|
||
docId: "self-hosting/deploy/overview",
|
||
position: "left",
|
||
},
|
||
{
|
||
type: "doc",
|
||
docId: "legal",
|
||
label: "Legal",
|
||
position: "right",
|
||
},
|
||
{
|
||
type: "html",
|
||
position: "right",
|
||
value:
|
||
'<a href="https://github.com/zitadel/zitadel/discussions" style="text-decoration: none; width: 20px; height: 24px; display: flex"><i class="las la-comments"></i></a>',
|
||
},
|
||
{
|
||
type: "html",
|
||
position: "right",
|
||
value:
|
||
'<a href="https://github.com/zitadel/zitadel" style="text-decoration: none; width: 20px; height: 24px; display: flex"><i class="lab la-github"></i></a>',
|
||
},
|
||
{
|
||
type: "html",
|
||
position: "right",
|
||
value:
|
||
'<a href="https://zitadel.com/chat" style="text-decoration: none; width: 20px; height: 24px; display: flex; margin: 0 .5rem 0 0"><i class="lab la-discord"></i></a>',
|
||
},
|
||
],
|
||
},
|
||
footer: {
|
||
links: [
|
||
{
|
||
title: "Community",
|
||
items: [
|
||
{
|
||
label: "Chat",
|
||
href: "https://zitadel.com/chat",
|
||
},
|
||
{
|
||
label: "GitHub Discussions",
|
||
href: "https://github.com/zitadel/zitadel/discussions",
|
||
},
|
||
{
|
||
label: "Twitter",
|
||
href: "https://twitter.com/zitadel",
|
||
},
|
||
{
|
||
label: "Linkedin",
|
||
href: "https://www.linkedin.com/company/zitadel/",
|
||
},
|
||
{
|
||
label: "Blog",
|
||
href: "https://zitadel.com/blog",
|
||
},
|
||
],
|
||
},
|
||
{
|
||
title: "Legal",
|
||
items: [
|
||
{
|
||
label: "Terms and Conditions",
|
||
href: "/legal/terms-of-service",
|
||
},
|
||
{
|
||
label: "Privacy Policy",
|
||
href: "/legal/policies/privacy-policy",
|
||
},
|
||
],
|
||
},
|
||
{
|
||
title: "About",
|
||
items: [
|
||
{
|
||
label: "Website",
|
||
href: "https://zitadel.com",
|
||
},
|
||
{
|
||
label: "Contact",
|
||
href: "https://zitadel.com/contact/",
|
||
},
|
||
{
|
||
label: "GitHub",
|
||
href: "https://github.com/zitadel",
|
||
},
|
||
{
|
||
label: "Status",
|
||
href: "https://status.zitadel.com/",
|
||
},
|
||
],
|
||
},
|
||
],
|
||
copyright: `Copyright © ${new Date().getFullYear()} ZITADEL Docs - Built with Docusaurus.`,
|
||
},
|
||
prism: {
|
||
additionalLanguages: [
|
||
"csharp",
|
||
"dart",
|
||
"groovy",
|
||
"regex",
|
||
"java",
|
||
"php",
|
||
"python",
|
||
"protobuf",
|
||
"json",
|
||
"bash",
|
||
],
|
||
},
|
||
colorMode: {
|
||
defaultMode: "dark",
|
||
disableSwitch: false,
|
||
respectPrefersColorScheme: true,
|
||
},
|
||
codeblock: {
|
||
showGithubLink: true,
|
||
githubLinkLabel: "View on GitHub",
|
||
showRunmeLink: false,
|
||
runmeLinkLabel: "Checkout via Runme",
|
||
},
|
||
},
|
||
presets: [
|
||
[
|
||
"classic",
|
||
/** @type {import('@docusaurus/preset-classic').Options} */
|
||
({
|
||
docs: {
|
||
routeBasePath: "/",
|
||
sidebarPath: require.resolve("./sidebars.js"),
|
||
showLastUpdateAuthor: true,
|
||
showLastUpdateTime: true,
|
||
editUrl: "https://github.com/zitadel/zitadel/edit/main/docs/",
|
||
remarkPlugins: [require("mdx-mermaid")],
|
||
docItemComponent: "@theme/ApiItem",
|
||
},
|
||
theme: {
|
||
customCss: require.resolve("./src/css/custom.css"),
|
||
},
|
||
}),
|
||
],
|
||
],
|
||
plugins: [
|
||
[
|
||
"@inkeep/cxkit-docusaurus",
|
||
{
|
||
SearchBar: {
|
||
baseSettings: {
|
||
apiKey: process.env.INKEEP_API_KEY,
|
||
primaryBrandColor: "#ff2069",
|
||
organizationDisplayName: "ZITADEL",
|
||
},
|
||
},
|
||
SearchSettings: {
|
||
tabs: ["All", "Docs", "GitHub", "Forums", "Discord"],
|
||
},
|
||
},
|
||
],
|
||
[
|
||
"@signalwire/docusaurus-plugin-llms-txt",
|
||
{
|
||
depth: 3,
|
||
logLevel: 1,
|
||
content: {
|
||
excludeRoutes: ["/search"],
|
||
enableMarkdownFiles: true,
|
||
},
|
||
},
|
||
],
|
||
[
|
||
"docusaurus-plugin-openapi-docs",
|
||
{
|
||
id: "apiDocs",
|
||
docsPluginId: "classic",
|
||
config: {
|
||
auth: {
|
||
specPath: ".artifacts/openapi/zitadel/auth.swagger.json",
|
||
outputDir: "docs/apis/resources/auth",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
mgmt: {
|
||
specPath: ".artifacts/openapi/zitadel/management.swagger.json",
|
||
outputDir: "docs/apis/resources/mgmt",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
admin: {
|
||
specPath: ".artifacts/openapi/zitadel/admin.swagger.json",
|
||
outputDir: "docs/apis/resources/admin",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
system: {
|
||
specPath: ".artifacts/openapi/zitadel/system.swagger.json",
|
||
outputDir: "docs/apis/resources/system",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
user_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/user/v2/user_service.swagger.json",
|
||
outputDir: "docs/apis/resources/user_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
session_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/session/v2/session_service.swagger.json",
|
||
outputDir: "docs/apis/resources/session_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
oidc_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/oidc/v2/oidc_service.swagger.json",
|
||
outputDir: "docs/apis/resources/oidc_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
saml_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/saml/v2/saml_service.swagger.json",
|
||
outputDir: "docs/apis/resources/saml_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
settings_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/settings/v2/settings_service.swagger.json",
|
||
outputDir: "docs/apis/resources/settings_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
action_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/action/v2beta/action_service.swagger.json",
|
||
outputDir: "docs/apis/resources/action_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
webkey_v2: {
|
||
specPath:
|
||
".artifacts/openapi3/zitadel/webkey/v2/webkey_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/webkey_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
feature_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/feature/v2/feature_service.swagger.json",
|
||
outputDir: "docs/apis/resources/feature_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
org_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/org/v2/org_service.swagger.json",
|
||
outputDir: "docs/apis/resources/org_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
idp_v2: {
|
||
specPath:
|
||
".artifacts/openapi/zitadel/idp/v2/idp_service.swagger.json",
|
||
outputDir: "docs/apis/resources/idp_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
org_v2beta: {
|
||
specPath:
|
||
".artifacts/openapi3/zitadel/org/v2beta/org_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/org_service_v2beta",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
project_v2beta: {
|
||
specPath:
|
||
".artifacts/openapi3/zitadel/project/v2beta/project_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/project_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
application_v2: {
|
||
specPath: ".artifacts/openapi3/zitadel/app/v2beta/app_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/application_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
instance_v2: {
|
||
specPath:
|
||
".artifacts/openapi3/zitadel/instance/v2beta/instance_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/instance_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
authorization_v2: {
|
||
specPath:
|
||
".artifacts/openapi3/zitadel/authorization/v2beta/authorization_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/authorization_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
internal_permission_v2: {
|
||
specPath:
|
||
".artifacts/openapi3/zitadel/internal_permission/v2beta/internal_permission_service.openapi.yaml",
|
||
outputDir: "docs/apis/resources/internal_permission_service_v2",
|
||
sidebarOptions: {
|
||
groupPathsBy: "tag",
|
||
categoryLinkSource: "auto",
|
||
},
|
||
},
|
||
},
|
||
},
|
||
],
|
||
require.resolve("docusaurus-plugin-image-zoom"),
|
||
async function myPlugin(context, options) {
|
||
return {
|
||
name: "docusaurus-tailwindcss",
|
||
configurePostCss(postcssOptions) {
|
||
// Appends TailwindCSS and AutoPrefixer.
|
||
postcssOptions.plugins.push(require("tailwindcss"));
|
||
postcssOptions.plugins.push(require("autoprefixer"));
|
||
return postcssOptions;
|
||
},
|
||
};
|
||
},
|
||
],
|
||
themes: [
|
||
"docusaurus-theme-github-codeblock",
|
||
"docusaurus-theme-openapi-docs",
|
||
],
|
||
future: {
|
||
v4: false, // Disabled because of some problems related to https://github.com/facebook/docusaurus/issues/11040
|
||
experimental_faster: {
|
||
swcJsLoader: false, // Disabled because of memory usage > 8GB which is a problem on vercel default runners
|
||
swcJsMinimizer: true,
|
||
swcHtmlMinimizer: true,
|
||
lightningCssMinimizer: true,
|
||
mdxCrossCompilerCache: true,
|
||
ssgWorkerThreads: false, // Disabled because of some problems related to https://github.com/facebook/docusaurus/issues/11040
|
||
rspackBundler: true,
|
||
rspackPersistentCache: true,
|
||
},
|
||
},
|
||
};
|