Skip to content

Commit

Permalink
docs: Rewrite readme and website documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
adrien2p authored Mar 9, 2022
1 parent f87390b commit 13b343f
Show file tree
Hide file tree
Showing 68 changed files with 18,619 additions and 1,443 deletions.
14 changes: 14 additions & 0 deletions .github/docs/_coverpage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<!-- _coverpage.md -->

![logo](https://github.com/adrien2p/medusa-extender/blob/assets/assets/logo.png?raw=true)

# Medusa-extender <small>1.4.5</small>

> Badass features on top of @medusajs
- Extend medusa core features to add custom fields and functionnalities
- Create new functionnalities
- Full typings and Modular architecture

[GitHub](https://github.com/adrien2p/medusa-extender)
[Get Started](https://adrien2p.github.io/medusa-extender/#/?id=getting-started-rocket)
28 changes: 23 additions & 5 deletions .github/docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,15 @@
name="og:description">
<meta content="summary_large_image" name="twitter:card">

<link href="https://github.com/adrien2p/medusa-extender/blob/assets/assets/logo.png?raw=true" rel="icon" type="image/x-icon">
<link href="https://cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css" rel="stylesheet"/>
<link href="https://github.com/adrien2p/medusa-extender/blob/assets/assets/logo.png?raw=true" rel="icon"
type="image/x-icon">
<link href="//cdn.jsdelivr.net/npm/docsify-darklight-theme@3/dist/docsify-themeable/style.min.css" rel="stylesheet"
type="text/css">
<!-- docsify-themeable styles-->
<link href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple.css" rel="stylesheet"
title="light">
<link href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple-dark.css"
rel="stylesheet alternative" title="dark">
</head>
<body>
<div data-app id="main">Please wait...</div>
Expand All @@ -28,15 +35,15 @@
el: "#main",
repo: 'https://github.com/adrien2p/medusa-extender',
themeColor: '#793ef9',
coverpage: true,
defaultTheme: 'light | dark',
search: {
maxAge: 86400000, // Expiration time, the default one day
paths: 'auto', // or 'auto'
placeholder: 'Type to search',
placeholder: 'Looking for something?',

noData: 'No Results!',

depth: 2,

hideOtherSidebarContent: false, // whether or not to hide other sidebar content
},
relativePath: true,
Expand All @@ -47,5 +54,16 @@
<script src="https://cdn.jsdelivr.net/npm/docsify/lib/plugins/emoji.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/docsify/lib/plugins/zoom-image.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/docsify-copy-code/dist/docsify-copy-code.min.js"></script>
<script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
<script src="//polyfill.io/v3/polyfill.min.js?features=String.prototype.normalize"></script>
<script
src="//cdn.jsdelivr.net/npm/docsify-darklight-theme@3/dist/docsify-themeable/main.min.js"
type="text/javascript">
</script>

<script
src="//cdn.jsdelivr.net/npm/docsify-darklight-theme@3/dist/docsify-themeable/index.min.js"
type="text/javascript">
</script>
</body>
</html>
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,4 +80,4 @@ Congratulations :tada::tada: The GitHub team thanks you :sparkles:.

Once your PR is merged, your contributions will be publicly visible on the [GitHubs docs](https://docs.github.com/en).

Now that you are part of the GitHub docs community, see how else you can [contribute to the docs](/contributing/types-of-contributions.md).
Now that you are part of the GitHub docs community, see how else you can [contribute to the docs](/contributing/types-of-contributions.md).
708 changes: 146 additions & 562 deletions README.md

Large diffs are not rendered by default.

112 changes: 112 additions & 0 deletions blueprint.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
{
"package": "package.json",
"blueprint": "blueprint.md",
"input": "blueprint.md",
"output": "readme/README.md",
"line": "cloudy",
"text": "Do you want to extend existing entities to add custom fields? Do you want to implement your own feature or extend existing one\n in a module way? Did you ever wanted to build something more than a single store?\n Well, this project has been made to help you reach you goal. It is now possible to customise\n Medusa in a way you will be able to enjoy all the awesome features that Medusa provides you\n but with the possibility to take your e-commerce project to the next level :rocket:",
"documentationConfig": {
"markdown": {
"titleLevel": 2
}
},
"headingPrefix": {
"1": "",
"2": "",
"3": ""
},
"ids": {
"github": "adrien2p/medusa-extender",
"npm": "medusa-extender"
},
"logo": {
"src": "https://github.com/adrien2p/medusa-extender/blob/assets/assets/logo.png?raw=true",
"width": 500,
"align": "center",
"alt": "Medusa-extender logo"
},
"badges": [
{
"alt": "Awesome medusajs",
"url": "https://github.com/adrien2p/awesome-medusajs",
"img": "https://awesome.re/badge.svg"
},
{
"alt": "Documentation",
"url": "https://adrien2p.github.io/medusa-extender/#/",
"img": "https://img.shields.io/badge/documentation-online-important"
},
{
"alt": "Twitter",
"url": "https://twitter.com/intent/tweet?text=Check%20this%20out!%20The%20new%20medusa%20headless%20e-commerce%20extender&url=https://github.com/adrien2p/medusa-extender",
"img": "https://badgen.net/badge/icon/twitter?icon=twitter&label=Share%20it%20on"
},
{
"alt": "Discord",
"url": "https://discord.gg/xpCwq3Kfn8",
"img": "https://img.shields.io/badge/chat-on%20discord-7289DA.svg"
},
{
"alt": "Npm download",
"url": "https://www.npmjs.com/package/medusa-extender",
"img": "https://img.shields.io/npm/dt/medusa-extender"
},
{
"alt": "Activity",
"url": "https://github.com/adrien2p/medusa-extender/commits/main",
"img": "https://img.shields.io/github/commit-activity/m/adrien2p/medusa-extender?style=flat"
},
{
"alt": "Issues",
"url": "https://github.com/adrien2p/medusa-extender/issues",
"img": "https://img.shields.io/github/issues/adrien2p/medusa-extender?style=flat"
},
{
"alt": "Licence",
"url": "https://github.com/adrien2p/medusa-extender/blob/main/LICENSE",
"img": "https://img.shields.io/github/license/adrien2p/medusa-extender?style=flat"
},
{
"alt": "Contributing",
"url": "https://github.com/adrien2p/medusa-extender/blob/main/CONTRIBUTING.md",
"img": "https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat"
},
{
"alt": "Test pipeline status",
"url": "https://github.com/adrien2p/medusa-extender/actions/workflows/action.yml",
"img": "https://github.com/adrien2p/medusa-extender/actions/workflows/action.yml/badge.svg"
},
{
"alt": "Page build deployment status",
"url": "https://github.com/adrien2p/medusa-extender/actions/workflows/pages/pages-build-deployment",
"img": "https://github.com/adrien2p/medusa-extender/actions/workflows/pages/pages-build-deployment/badge.svg"
},
{
"alt": "CodeQL security analysis status",
"url": "https://github.com/adrien2p/medusa-extender/actions/workflows/codeql-analysis.yml",
"img": "https://github.com/adrien2p/medusa-extender/actions/workflows/codeql-analysis.yml/badge.svg"
},
{
"alt": "Product hunt",
"url": "https://www.producthunt.com/posts/medusa-extender?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-medusa-extender",
"img": "https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=333482&theme=dark"
}
],
"templates": [
{
"name": "monitoring-demo-video",
"template": "[![Video demo: scoped products per store](https://raw.githubusercontent.com/adrien2p/medusa-extender/assets/assets/readme/monitoring-ss.png)](https://streamable.com/k3ivnk)"
}
],
"decoratorApiSummary": [
["Decorator", "Parameters", "Description"],
["`@Entity`", "`{ resolutionKey?: string; override?: Type<TOverride>; }`", "Allow to create a new entity or to override an existing entity from medusa."],
["`@Repository`", "`{ resolutionKey?: string; override?: Type<TOverride>; }`", "Allow to create a new custom repository or to override an existing custom repository from medusa."],
["`@Service`", "`{ scope?: LifetimeType; resolutionKey?: string; override?: Type<TOverride>; }`", "Allow to create a new service or to override an existing service from medusa."],
["`@Middleware`", "`{ requireAuth: boolean; routes: MedusaRouteOptions[]; }`", "Allow to apply a custom middleware that will be resolve before or after the authentication on the specified routes."],
["`@Router`", "`{ requiredAuth: boolean; method: MedusaRouteMethods; path: string; handlers: ((...args: unknown[]) => void)[]; }`", "Allow to register new custom routes with a set of handlers."],
["`@Validator`", "`{ override: Type<TOverride>; }`", "Allow to override an existing validator from medusa."],
["`@Migration`", "", "Create a new migration to applied for your entity modifications."],
["`@OnMedusaEntityEvent.When.Action`", "take an entity and an option object such as `{ async: boolean; metatype?: Type; }`", "Emit and listen to entity subscriber events."]
]
}
26 changes: 26 additions & 0 deletions blueprint.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
{{ template:logo }}
{{ template:title }}

<h4 align="center">
<a href="https://adrien2p.github.io/medusa-extender/#/" alt="Full documentation">Full documentation website</a>
</h4>

{{ template:badges }}
{{ template:description }}

<p align="center">
<a href="https://www.buymeacoffee.com/adriendeperetti" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
</p>

{{ template:toc }}

{{ load:readme/01-getting-started.md }}
{{ load:readme/06-integration-with-medusa.md }}
{{ load:readme/09-features.md }}
{{ load:readme/02-api-documentation.md }}
{{ load:readme/03-starters.md }}
{{ load:readme/04-internal-modules.md }}
{{ load:readme/05-resources.md }}
{{ load:readme/07-discussions.md }}
{{ load:readme/10-like-my-work.md }}
{{ load:readme/08-contribute.md }}
Loading

0 comments on commit 13b343f

Please sign in to comment.