Skip to content
This repository was archived by the owner on Nov 21, 2025. It is now read-only.

Commit 1d61e02

Browse files
authored
fix(docz-core): add pathPrefix from config (#1214)
* fix(docz-core): add pathPrefix from config * docs: add custom-base example * ci: triggering re-build
1 parent ce18cb0 commit 1d61e02

File tree

10 files changed

+153
-0
lines changed

10 files changed

+153
-0
lines changed

core/docz-core/src/bundler/build.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ export const build: BuildFn = async (config, dist) => {
1515
// Append gatsby option `prefixPaths`to CLI args
1616
// https://www.gatsbyjs.org/docs/path-prefix/
1717
cliArgs.push('--prefixPaths')
18+
cliArgs.push(config.base)
1819
}
1920
ensureFiles({ args: config })
2021
sh.cd(paths.docz)

core/docz-core/src/commands/serve.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ export const serve = async (args: Arguments<any>) => {
1313
// Append gatsby option `prefixPaths`to CLI args
1414
// https://www.gatsbyjs.org/docs/path-prefix/
1515
cliArgs.push('--prefixPaths')
16+
cliArgs.push(config.base)
1617
}
1718

1819
sh.cd(paths.docz)
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
.docz
2+
node_modules
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# Basic Docz example
2+
3+
## Using `create-docz-app`
4+
5+
```sh
6+
npx create-docz-app docz-app-basic
7+
# or
8+
yarn create docz-app docz-app-basic
9+
```
10+
11+
## Download manually
12+
13+
```sh
14+
curl https://codeload.github.com/doczjs/docz/tar.gz/master | tar -xz --strip=2 docz-master/examples/basic
15+
mv basic docz-basic-example
16+
cd docz-basic-example
17+
```
18+
19+
## Setup
20+
21+
```sh
22+
yarn # npm i
23+
```
24+
25+
## Run
26+
27+
```sh
28+
yarn dev # npm run dev
29+
```
30+
31+
## Build
32+
33+
```sh
34+
yarn build # npm run build
35+
```
36+
37+
## Serve built app
38+
39+
```sh
40+
yarn serve # npm run serve
41+
```
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
export default {
2+
base: '/base-path/',
3+
}
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"name": "docz-example-basic",
3+
"private": true,
4+
"version": "2.0.0-rc.41",
5+
"license": "MIT",
6+
"files": [
7+
"src/",
8+
"doczrc.js",
9+
"package.json"
10+
],
11+
"scripts": {
12+
"dev": "docz dev",
13+
"build": "docz build",
14+
"serve": "docz serve"
15+
},
16+
"dependencies": {
17+
"docz": "next",
18+
"prop-types": "^15.7.2",
19+
"react": "^16.8.6",
20+
"react-dom": "^16.8.6",
21+
"scheduler": "^0.15.0"
22+
}
23+
}
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
import React from 'react'
2+
import t from 'prop-types'
3+
4+
const kinds = {
5+
info: '#5352ED',
6+
positive: '#2ED573',
7+
negative: '#FF4757',
8+
warning: '#FFA502',
9+
}
10+
11+
const AlertStyled = ({ children, kind, ...rest }) => (
12+
<div
13+
style={{
14+
padding: 20,
15+
background: 'white',
16+
borderRadius: 3,
17+
color: 'white',
18+
background: kinds[kind],
19+
}}
20+
{...rest}
21+
>
22+
{children}
23+
</div>
24+
)
25+
26+
export const Alert = props => <AlertStyled {...props} />
27+
28+
Alert.propTypes = {
29+
kind: t.oneOf(['info', 'positive', 'negative', 'warning']),
30+
}
31+
32+
Alert.defaultProps = {
33+
kind: 'info',
34+
}
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
name: Alert
3+
menu: Components
4+
---
5+
6+
import { Playground, Props } from 'docz'
7+
import { Alert } from './Alert'
8+
9+
# Alert
10+
11+
## Properties
12+
13+
<Props of={Alert} />
14+
15+
## Basic usage
16+
17+
<Playground>
18+
<Alert>Some message</Alert>
19+
</Playground>
20+
21+
## Using different kinds
22+
23+
<Playground>
24+
<Alert kind="info">Some message</Alert>
25+
<Alert kind="positive">Some message</Alert>
26+
<Alert kind="negative">Some message</Alert>
27+
<Alert kind="warning">Some message</Alert>
28+
</Playground>
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: Getting Started
3+
route: /
4+
---
5+
6+
# Getting Started
7+
8+
Design systems enable teams to build better products faster by making design reusable—reusability makes scale possible. This is the heart and primary value of design systems. A design system is a collection of reusable components, guided by clear standards, that can be assembled together to build any number of applications.
9+
10+
Regardless of the technologies and tools behind them, a successful design system follows these guiding principles:
11+
12+
- **It’s consistent**. The way components are built and managed follows a predictable pattern.
13+
- **It’s self-contained**. Your design system is treated as a standalone dependency.
14+
- **It’s reusable**. You’ve built components so they can be reused in many contexts.
15+
- **It’s accessible**. Applications built with your design system are usable by as many people as possible, no matter how they access the web.
16+
- **It’s robust**. No matter the product or platform to which your design system is applied, it should perform with grace and minimal bugs.
17+
18+
## Consistency
19+
20+
Your first, most important task when starting out is to define the rules of your system, document them, and ensure that everyone follows them. When you have clearly documented code standards and best practices in place, designers and developers from across your organization can easily use and, more importantly, contribute to your design system.

tmp-delete

Whitespace-only changes.

0 commit comments

Comments
 (0)