Next.jsReactStarter

nextjs-with-aos-example — Next.js Starter Template

By brunos3d

An example starter that integrates the AOS scroll animation library into a Next.js project, demonstrating how to initialize AOS and add styles for browsers with JavaScript disabled.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

Demonstrates a complete integration of the AOS scroll animation library in Next.js

02

Initializes AOS with the page in _app.tsx

03

Infers styles for AOS in _document.tsx, accommodating browsers with JavaScript disabled

04

Based on the create-next-app TypeScript starter template, with a familiar structure

05

Provides an online demo site to view scroll animation effects directly

06

Uses the MIT license, permitting free use, modification, commercial use, and distribution

Template Details

This template is a Next.js-based example project whose core purpose is to integrate the Animate On Scroll Library (AOS) into a Next.js application to achieve scroll-triggered element reveal animations. In the README, the author explains the motivation: repeatedly adding scroll event listeners directly in a project tends to cause maintenance and performance issues, so the responsibility for scroll animations is delegated to AOS.

The template focuses on two integration points for AOS in Next.js: initializing AOS with the page in _app.tsx, and inferring styles for AOS in _document.tsx so that content displays correctly even in browsers with JavaScript disabled. The project structure follows the TypeScript starter template from create-next-app; the README notes that this base template comes from João Pedro Schmitz.

There are two ways to use it: create a project directly from this repository as a template via create-next-app's -e flag, or clone the repository and run dependency installation and development commands in the project directory, previewing locally on port 3000 by default. The repository uses the MIT license, allowing free use, modification, commercial use, and distribution, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services such as domains and hosting may incur additional charges.

Next.jsReactStarter

Is it right for your project?

Use Cases

  • When you need to add scroll-triggered reveal animations to a Next.js project, refer to its integration approach
  • When you want to understand how AOS is configured in Next.js's _app and _document, use it as a reference example
  • Quickly start a TypeScript project with scroll animations using the create-next-app template method
  • Evaluate the feasibility of migrating scroll animation logic from custom event listeners to AOS

Suitable For

  • Front-end developers using Next.js and React
  • Developers who need to add scroll animation effects to pages
  • Developers who want to quickly start a TypeScript project with a ready-made template
  • Learners who want to reference how AOS is initialized and styled in Next.js

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Recommended: use npx create-next-app ts-next -e https://github.com/brunos3d/nextjs-with-aos-example to create a project directly from this repository as a template

  2. 2

    Alternatively, clone the repository and run npm install or yarn in the project directory to install dependencies

  3. 3

    After installation, run yarn dev to start the development server

  4. 4

    Open http://localhost:3000 in your browser to view the project

  5. 5

    Third-party assets such as demo images, fonts, and icons require separate license verification

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in a public repository; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets require separate license verification and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 77 / 100
Technologies
Next.js · React
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2024-01-11
Screenshot last checked
2026-10-02

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Next.js as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 176160af77a0bd2b33eeb981967462532194c9554fe46fb484e6ed763b293c7c

2026-10-02T20:45:56.282Z

Source file / repository
# nextjs-with-aos-example

🔺 NEXT.JS - Example project using Next.js with [Animate On Scroll Library](https://www.npmjs.com/package/aos).

### 🚀 [Demo](https://nextjs-with-aos-example.vercel.app/)

## 💬 Explanations

This project was created from the need to implement `reveal scroll animations` in projects using [Next.js](https://nextjs.org/).
As simple as it sounds, most of the time it becomes a headache when you start running into performance issues from multiple additions of event listeners to your site's DOM.
One solution is to externalize this responsibility using [AOS](https://www.npmjs.com/package/aos).
However this has some points of attention such as for example:
- [Initialize AOS](https://github.com/BrunoS3D/nextjs-with-aos-example/blob/461faf6325f8599ee09f226d15774c8905e2fdab/src/pages/_app.tsx#L10) with your page
- [Infer styles](https://github.com/BrunoS3D/nextjs-with-aos-example/blob/461faf6325f8599ee09f226d15774c8905e2fdab/src/pages/_document.tsx#L18) for AOS to work on browsers whose javascript has been disabled

With this I decided to create a template that helps me in creating projects with next using everything that is best created by my friend [João Pedro Schmitz](https://github.com/jpedroschmitz).

## 🚀 Getting started

The best way to start with this template is using `create-next-app`.

```
npx create-next-app ts-next -e https://github.com/brunos3d/nextjs-with-aos-example
```

If you prefer you can clone this repository and run the following commands inside the project folder:

1. `npm install` or `yarn`;
2. `yarn dev`;

To view the project open `http://localhost:3000`.

**After your pull request is merged**, you can safely delete your branch.

## 📝 License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for more information.

---

Template made by [João Pedro Schmitz](https://github.com/jpedroschmitz)

AOS Implementations made with 💜 by [Bruno Silva](https://github.com/brunos3d)
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.