From 8022c82c91b50055c1afd96008bc014bc297bb66 Mon Sep 17 00:00:00 2001
From: Andrij Orlenko <94047334+lotyp@users.noreply.github.com>
Date: Wed, 11 Jan 2023 16:49:58 +0200
Subject: [PATCH] docs: adding guide, readme refactor (#44)
---
Makefile | 2 +-
README.md | 166 ++++++++--------------
apps/docs/.secretlintignore | 2 +
apps/docs/pages/guide/getting-started.mdx | 23 +++
apps/docs/theme.config.tsx | 5 +-
assets/vb-logo.png | Bin 0 -> 4499 bytes
6 files changed, 90 insertions(+), 108 deletions(-)
create mode 100644 apps/docs/.secretlintignore
create mode 100644 assets/vb-logo.png
diff --git a/Makefile b/Makefile
index c70c3986..95c88c93 100644
--- a/Makefile
+++ b/Makefile
@@ -80,7 +80,7 @@ help: ## Show this menu
# Default action
# Defines default command when `make` is executed without additional parameters
# ------------------------------------------------------------------------------------
-all: install hooks up
+all: install hooks
.PHONY: all
diff --git a/README.md b/README.md
index 9845522a..1747a88d 100644
--- a/README.md
+++ b/README.md
@@ -4,11 +4,14 @@
-
+
+
-
# NextJS Starter Template
@@ -43,12 +45,24 @@ You can use it with the backend template, written in Laravel — [laravel-starte
This turborepo uses [pnpm](https://pnpm.io) as a package manager. It includes the following packages/apps:
+### → Structure
+
+```bash
+.
+├── apps
+│ ├── web (nextjs app - i18n, ssr, api, jest, cypress)
+│ └── docs (nextra app)
+└── packages
+ ├── common-i18n (locales...)
+ ├── jest-config (shared jest configs)
+ ├── eslint-config-custom (shared eslint configs)
+ └── ui (react stub components)
+```
+
### → Apps
- `docs`: a [Nextra](https://nextra.site/) documentation template generated from [Nextra: Docs Starter Kit](https://vercel.com/templates/next.js/documentation-starter-kit)
-
- [DEMO docs app](https://next-starter-tpl-docs.vercel.app/)
-
- `web`: [Next.js](https://nextjs.org/) app with tailwindcss and sentry support
- [DEMO web app](https://next-starter-tpl-web.vercel.app/)
@@ -101,117 +115,22 @@ This repository has some additional tools already setup for you:
-## 💿 Installation
+## 💿 Installation and Usage
> Warning: Repository with [docker-shared-services](https://github.com/wayofdev/docker-shared-services) should be configured, up and running, to ensure system wide TLS and DNS support.
-### → Instructions
-
-- First, setup, for this repository, compatible backend by following instructions in [laravel-starter-tpl](https://github.com/wayofdev/laravel-starter-tpl)
-
-- After backend is set up done, clone this repository:
-
- ```bash
- git@github.com:wayofdev/next-starter-tpl.git
- ```
-
-- Create `.env` file:
-
- ```bash
- $ make env \
- APP_NAME=tpl \
- SYSTEM_SERVICES_NAMESPACE=ss \
- PROJECT_SERVICES_NAMESPACE=wod
- ```
-
-- Build, install and run application:
-
- ```bash
- make
- ```
-
-- Now, project is running, and, if default settings were used, available at [https://tpl.wod.docker](https://tpl.wod.docker)
-
-
-
-## 💻 Usage
-
-### → Build
-
-To build all apps and packages, run the following command:
-
-```bash
-# with makefile, through Docker
-$ make build
-
-# or, directly, without docker, using system binaries
-$ pnpm run build
-```
-
-
-
-### → Develop
-
-To develop all apps and packages, run the following command:
-
-```bash
-# with makefile, through Docker
-$ make up
-
-# or, directly, without docker, using system binaries
-$ pnpm run dev
-```
-
-
-
-### → Remote Caching
-
-Turborepo can use a technique known as [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching) to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.
-
-By default, Turborepo will cache locally. To enable Remote Caching you will need an account with Vercel. If you don't have an account you can [create one](https://vercel.com/signup), then enter the following commands:
-
-```bash
-# with makefile
-$ make turbo-login
-
-# directly
-$ pnpm dlx turbo login
-```
-
-This will authenticate the Turborepo CLI with your [Vercel account](https://vercel.com/docs/concepts/personal-accounts/overview).
-
-Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your turborepo:
-
-```bash
-# with makefile
-$ make turbo-link
-
-# directly
-$ pnpm dlx turbo link
-```
-
-
-
-## 🧪 Testing
-
-You can check `Makefile` or `package.json` to get full list of commands for local testing. For testing, you can use these commands to test:
-
-```bash
-make test
-```
+**[Follow getting-started guide in documentation](https://next-starter-tpl-docs.wayof.dev/guide/getting-started)** 🔗
## 🤝 License
[](./LICENSE)
-[](https://app.fossa.com/projects/git%2Bgithub.com%2Fwayofdev%2Fnext-starter-tpl?ref=badge_shield)
-
-
-
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fwayofdev%2Fnext-starter-tpl?ref=badge_large)
+
+
## 🧱 Credits and Useful Resources
Based on [nextjs-monorepo-example](https://github.com/belgattitude/nextjs-monorepo-example) template from [belgattitude](https://github.com/belgattitude).
@@ -256,4 +175,43 @@ This repository was created in **2022** by [lotyp / wayofdev](https://github.com
-
\ No newline at end of file
+
+
+## 🤑 Sponsors
+
+
+
+
+
+
+ 
+ Reproto
+ 🎖️ Financial Support
+ |
+
+
+ 
+ Vercel
+ ☁️ Infrastructure Support
+ |
+
+
+ 
+ Sentry
+ ☁️ Infrastructure Support
+ |
+
+
+ 
+ ZenHub
+ ☁️ Infrastructure Support
+ |
+
+
+ 
+ —
+ —
+ |
+
+
+
diff --git a/apps/docs/.secretlintignore b/apps/docs/.secretlintignore
new file mode 100644
index 00000000..b1dbbf8d
--- /dev/null
+++ b/apps/docs/.secretlintignore
@@ -0,0 +1,2 @@
+# next.js build output
+.next
diff --git a/apps/docs/pages/guide/getting-started.mdx b/apps/docs/pages/guide/getting-started.mdx
index ad588e01..e23d13c6 100644
--- a/apps/docs/pages/guide/getting-started.mdx
+++ b/apps/docs/pages/guide/getting-started.mdx
@@ -109,4 +109,27 @@ $ make env \
Change generated `.env` file to match your needs, if needed.
+### → Install Dependencies
+
+This command will install all dependencies, through docker container, for this mono-repo and all dependencies.
+
+```bash
+# default action - runs `make install` and setups git hooks
+$ make
+
+# or, run each step separately
+$ make install
+$ make hooks
+```
+
+### → Run docker container in dev mode
+
+This command will start docker container in dev mode, with hot reloading enabled.
+
+```bash
+make up
+```
+
+Project can be accessed at [tpl.docker](https://tpl.docker)
+
diff --git a/apps/docs/theme.config.tsx b/apps/docs/theme.config.tsx
index 8c10fbc1..e767cee1 100644
--- a/apps/docs/theme.config.tsx
+++ b/apps/docs/theme.config.tsx
@@ -1,5 +1,5 @@
import type { DocsThemeConfig } from 'nextra-theme-docs'
-import React from 'react'
+import { Fragment } from 'react'
const config: DocsThemeConfig = {
i18n: [{ locale: 'en-US', text: 'English' }],
@@ -15,8 +15,7 @@ const config: DocsThemeConfig = {
text: 'NextJS Starter Tpl',
},
toc: {
- extraContent:
,
- float: true,
+ extraContent: ,
},
useNextSeoProps() {
return {
diff --git a/assets/vb-logo.png b/assets/vb-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..08c60dbd11b513f2315455e8b9779845e2ba56a2
GIT binary patch
literal 4499
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