Skip to content

Commit 64b40b4

Browse files
committed
docs: add detailed README.md
1 parent 571ed52 commit 64b40b4

File tree

2 files changed

+276
-19
lines changed

2 files changed

+276
-19
lines changed

README.md

Lines changed: 276 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,293 @@
1-
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
1+
# Next.js 14 SaaS Landing Page
22

3-
## Getting Started
3+
<!-- GitHub badges -->
44

5-
First, run the development server:
5+
[![Latest release](https://img.shields.io/github/v/release/ladunjexa/nextjs14-saas-landing-page?label=Latest%20release&style=social)](https://github.com/ladunjexa/nextjs14-saas-landing-page/releases/tag/v0.1.0)
6+
[![Stars](https://img.shields.io/github/stars/ladunjexa/nextjs14-saas-landing-page?style=social)](https://github.com/ladunjexa/nextjs14-saas-landing-page/stargazers)
7+
[![Fork](https://img.shields.io/github/forks/ladunjexa/nextjs14-saas-landing-page?style=social)](https://github.com/ladunjexa/nextjs14-saas-landing-page/forks)
8+
[![GitHub commits](https://img.shields.io/github/commit-activity/t/ladunjexa/nextjs14-saas-landing-page?style=social&logo=github)](https://github.com/ladunjexa/nextjs14-saas-landing-page/commits)
9+
[![Pull requests](https://img.shields.io/github/issues-pr/ladunjexa/nextjs14-saas-landing-page?style=social&logo=github)](https://github.com/ladunjexa/nextjs14-saas-landing-page/pulls)
10+
11+
![demo](./public/thumbnail.png)
12+
13+
[![ladunjexa](https://custom-icon-badges.demolab.com/badge/made%20by%20-ladunjexa-556bf2?logo=github&logoColor=white&labelColor=101827)](https://github.com/luadnjexa)
14+
[![License](https://img.shields.io/github/license/ladunjexa/nextjs14-saas-landing-page?color=dddddd&labelColor=000000)](https://github.com/ladunjexa/nextjs14-saas-landing-page/blob/main/LICENSE)
15+
[![Top Language](https://img.shields.io/github/languages/top/ladunjexa/nextjs14-saas-landing-page?logo=github&logoColor=%23007ACC&label=TypeScript)](https://www.typescriptlang.org/)
16+
[![Contributors](https://img.shields.io/github/contributors/ladunjexa/nextjs14-saas-landing-page?style=flat&color=orange&label=Contributors)](https://github.com/ladunjexa/nextjs14-saas-landing-page/graphs/contributors)
17+
![Release](https://img.shields.io/github/release/ladunjexa/nextjs14-saas-landing-page.svg)
18+
![PRs](https://img.shields.io/badge/PRs-welcome-ff69b4.svg?style=shields)
19+
![deployment](https://img.shields.io/github/deployments/ladunjexa/nextjs14-saas-landing-page/Production?logo=vercel&label=Website)
20+
[![Known Vulnerabilities](https://snyk.io/test/github/ladunjexa/nextjs14-saas-landing-page/badge.svg)](https://snyk.io/test/github/ladunjexa/nextjs14-saas-landing-page)
21+
22+
## 🌐 Live Demo
23+
24+
Explore the live demonstration of the project:
25+
[nextjs14-saas-landing-page](https://nextjs14-saas-landing-page.vercel.app/)
26+
27+
## 📝 Description
28+
29+
**Brainwave** is a Modern UI/UX website, developed using React.js and Tailwind CSS, exemplifies
30+
modern UI/UX principles. Its sleek design, seamless animations, and overall user experience set a
31+
high standard, serving as a reference or inspiration for future modern applications or websites in
32+
general.
33+
34+
<details><summary><b>Folder Structure</b></summary>
35+
36+
```bash
37+
nextjs14-saas-landing-page/
38+
├── .vscode/
39+
│ └── settings.json
40+
├── app/
41+
│ ├── favicon.ico
42+
│ ├── globals.css
43+
│ ├── page.tsx
44+
│ └── layout.tsx
45+
├── components/
46+
│ ├── atoms/
47+
│ │ ├── button.tsx
48+
│ │ ├── generating.tsx
49+
│ │ ├── heading.tsx
50+
│ │ └── tagline.tsx
51+
│ ├── design/
52+
│ │ ├── benefits.tsx
53+
│ │ ├── collaboration.tsx
54+
│ │ ├── hero.tsx
55+
│ │ ├── navbar.tsx
56+
│ │ ├── pricing.tsx
57+
│ │ ├── roadmap.tsx
58+
│ │ └── services.tsx
59+
│ ├── layout/
60+
│ │ ├── footer.tsx
61+
│ │ ├── navbar.tsx
62+
│ │ └── section.tsx
63+
│ ├── sections/
64+
│ │ ├── benefits/index.tsx
65+
│ │ ├── collaboration/index.tsx
66+
│ │ ├── hero/
67+
│ │ │ ├── company-logos.tsx
68+
│ │ │ ├── notification.tsx
69+
│ │ │ └── index.tsx
70+
│ │ ├── pricing/
71+
│ │ │ ├── pricing-list.tsx
72+
│ │ │ └── index.tsx
73+
│ │ ├── roadmap/index.tsx
74+
│ │ └── services/index.tsx
75+
│ └── svg/
76+
│ ├── arrow.tsx
77+
│ ├── brackets.tsx
78+
│ ├── button-gradient.tsx
79+
│ ├── chat-bubble-wing.tsx
80+
│ ├── clip-path.tsx
81+
│ ├── menu-svg.tsx
82+
│ ├── plus-svg.tsx
83+
│ └── section-svg.tsx
84+
├── constants/
85+
│ └── index.ts
86+
├── hooks/
87+
│ └── use-get-call-by-id.ts
88+
├── lib/
89+
│ └── utils.ts
90+
├── public/
91+
│ ├── assets/[[...slug]]/[[...]].{png,svg,jpg}
92+
│ ├── thumbnail.png
93+
│ ├── next.svg
94+
│ └── vercel.svg
95+
├── .eslintignore
96+
├── .eslintrc.json
97+
├── .gitignore
98+
├── .prettierignore
99+
├── .prettierrc
100+
├── next-env.d.ts
101+
├── next.config.mjs
102+
├── package-lock.json
103+
├── package.json
104+
├── postcss.config.mjs
105+
├── README.md
106+
├── tailwind.config.ts
107+
└── tsconfig.json
108+
```
109+
110+
</details>
111+
112+
## 📖 Table of Contents
113+
114+
<details><summary>Table of Contents</summary>
115+
116+
- [Live Demo](#-live-demo)
117+
- [Description](#-description)
118+
- [Technologies Used](#-technologies-used)
119+
- [Get Started](#-get-started)
120+
- [Prerequisites](#-prerequisites)
121+
- [Installation and Run Locally](#-installation-and-run-locally)
122+
- [Scripts](#-scripts)
123+
- [Deployment](#-deployment)
124+
- [Deploy to production (manual)](#-deploy-to-production-manual)
125+
- [Deploy on Vercel (recommended)](#-deploy-on-vercel-recommended)
126+
- [Deploy on Netlify](#-deploy-on-netlify)
127+
- [Contributing](#-contributing)
128+
- [Bug / Feature Request](#-bug--feature-request)
129+
- [Acknowledgements](#-acknowledgements)
130+
- [Contact Us](#-contact-us)
131+
- [License](#-license)
132+
133+
</details>
134+
135+
## ✨ Technologies Used
136+
137+
<details><summary><b>Brianwave</b> is built using the following technologies:</summary>
138+
139+
- [TypeScript](https://www.typescriptlang.org/): TypeScript is a typed superset of JavaScript that
140+
compiles to plain JavaScript.
141+
- [Next.js](https://nextjs.org/): Next.js is a React framework for building server-side rendered and
142+
statically generated web applications.
143+
- [Tailwind CSS](https://tailwindcss.com/): Tailwind CSS is a utility-first CSS framework for
144+
rapidly building custom user interfaces.
145+
- [ESLint](https://eslint.org/): ESLint is a static code analysis tool for identifying problematic
146+
patterns found in JavaScript code.
147+
- [Prettier](https://prettier.io/): Prettier is an opinionated code formatter.
148+
- [React Just Parallax](https://www.npmjs.com/package/react-just-parallax): React Just Parallax is a
149+
simple and lightweight parallax component for React.
150+
- [Vercel](https://vercel.com/): Vercel is a cloud platform for frontend developers, providing the
151+
frameworks, workflows, and infrastructure to build a faster, more personalized Web.
152+
153+
</details><br/>
154+
155+
[![Technologies Used](https://skillicons.dev/icons?i=ts,nextjs,tailwind,vercel)](https://skillicons.dev)
156+
157+
## 🧰 Get Started
158+
159+
To get this project up and running in your development environment, follow these step-by-step
160+
instructions.
161+
162+
### 📋 Prerequisites
163+
164+
In order to install and run this project locally, you would need to have the following installed on
165+
your local machine.
166+
167+
- [Node.js](https://nodejs.org/en/)
168+
- [NPM](https://www.npmjs.com/get-npm)
169+
- [Git](https://git-scm.com/downloads)
170+
171+
### ⚙️ Installation and Run Locally
172+
173+
**Step 1:**
174+
175+
Download or clone this repo by using the link below:
176+
177+
```bash
178+
git clone https://github.com/ladunjexa/nextjs14-saas-landing-page.git
179+
```
180+
181+
**Step 2:**
182+
183+
Execute the following command in the root directory of the downloaded repo in order to install
184+
dependencies:
185+
186+
```bash
187+
npm install
188+
```
189+
190+
**Step 3:**
191+
192+
Execute the following command in order to run the development server locally:
6193

7194
```bash
8195
npm run dev
9-
# or
10-
yarn dev
11-
# or
12-
pnpm dev
13-
# or
14-
bun dev
15196
```
16197

198+
**Step 4:**
199+
17200
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
18201

19-
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
202+
### 📜 Scripts
203+
204+
All scripts are defined in the `package.json` file. Here is a list of all scripts:
205+
206+
| Script | Action |
207+
| :------------------ | :------------------------------------------ |
208+
| `npm install` | Installs dependencies |
209+
| `npm run dev` | Starts local dev server at `localhost:3000` |
210+
| `npm run build` | Build your production site to `./dist/` |
211+
| `npm run start` | Start your production site locally |
212+
| `npm run lint` | Run ESLint |
213+
| `npm run ts:check:` | Run TypeScript type checking |
214+
215+
## 🚀 Deployment
216+
217+
#### Deploy to production (manual)
218+
219+
You can create an optimized production build with the following command:
220+
221+
```bash
222+
npm run build
223+
```
224+
225+
#### Deploy on Vercel (recommended)
226+
227+
The easiest way to deploy this Next.js app is to use the
228+
[Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme).
229+
230+
[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fladunjexa%2Fnextjs14-saas-landing-page)
231+
232+
#### Deploy on Netlify
233+
234+
You can also deploy this Next.js app with [Netlify](https://www.netlify.com/).
235+
236+
[![Deploy with Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/ladunjexa/nextjs14-saas-landing-page)
237+
238+
Check out [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
239+
240+
## 🔧 Contributing
241+
242+
[![contributors](https://contrib.rocks/image?repo=ladunjexa/nextjs14-saas-landing-page)](https://github.com/ladunjexa/nextjs14-saas-landing-page/graphs/contributors)
243+
244+
Contributions are what make the open source community such an amazing place to learn, inspire, and
245+
create. Any contributions you make are **greatly appreciated**.
246+
247+
To fix a bug or enhance an existing module, follow these steps:
248+
249+
1. Fork the repo
250+
2. Create a new branch (`git checkout -b improve-feature`)
251+
3. Make the appropriate changes in the files
252+
4. Commit your changes (`git commit -am 'Improve feature'`)
253+
5. Push to the branch (`git push origin improve-feature`)
254+
6. Create a Pull Request 🎉
255+
256+
### 📩 Bug / Feature Request
257+
258+
If you find a bug (failure of a module to execute its intended function), kindly open an issue
259+
[here](https://github.com/ladunjexa/nextjs14-saas-landing-page/issues/new) by including the issue
260+
with a title and clear description.
261+
262+
If you'd like to request a new function, feel free to do so by opening an issue
263+
[here](https://github.com/ladunjexa/nextjs14-saas-landing-page/issues/new). Please include sample
264+
queries and their corresponding results.
20265

21-
This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
266+
## 💎 Acknowledgements
22267

23-
## Learn More
268+
I'd like to express my gratitude to the following people who helped me with this project and made it
269+
possible:
24270

25-
To learn more about Next.js, take a look at the following resources:
271+
- [Next.js](https://nextjs.org/)
272+
- [Tailwind CSS](https://tailwindcss.com/)
273+
- [Prettier](https://prettier.io/)
274+
- [ESLint](https://eslint.org/)
275+
- [Vercel](https://vercel.com/)
276+
- [React Just Parallax](https://www.npmjs.com/package/react-just-parallax)
277+
- [JavaScript Mastery](https://www.jsmastery.pro/)
26278

27-
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
28-
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
279+
## 📞 Contact Us
29280

30-
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
281+
[![Telegram](https://img.shields.io/badge/Telegram-@ladunjexa-2CA5E0?style=social&logo=telegram&logoColor=000000)](https://t.me/ladunjexa)
282+
[![LinkedIn](https://img.shields.io/badge/LinkedIn-ladunjexa-blue?style=flat&logo=linkedin&logoColor=b0c0c0&labelColor=363D44)](https://www.linkedin.com/in/lironabutbul)
283+
[![Instagram](https://img.shields.io/badge/Instagram-ladunjexa-grey?style=flat&logo=instagram&logoColor=b0c0c0&labelColor=8134af)](https://www.instagram.com/ladunjexa)
284+
[![Discord](https://img.shields.io/badge/Discord-ladunjexa-7289da?style=flat&logo=discord&logoColor=b0c0c0&labelColor=2c2f33)](https://discord.com/users/827996364331810816)
31285

32-
## Deploy on Vercel
286+
<!-- [![Twitter](https://img.shields.io/twitter/follow/ladunjexa.svg?style=social)](https://twitter.com/intent/follow?screen_name=ladunjexa) -->
33287

34-
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
288+
## 📋 License
35289

36-
Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
290+
**Brianwave** is open source software [licensed as MIT](https://opensource.org/license/mit/) and is
291+
free to use — See
292+
[LICENSE](https://github.com/ladunjexa/nextjs14-saas-landing-page/blob/main/LICENSE) for more
293+
details.

public/thumbnail.png

1.07 MB
Loading

0 commit comments

Comments
 (0)