⚡️Fleek Next Adapter

The Fleek Next.js adapter allows you to deploy your server-side Next.js application on Fleek.

🚧 Work in Progress 🚧

This repository is currently under development and is a Work in Progress. Features and functionalities may change frequently.

Installation

• npm

npm install @fleek-platform/next

• pnpm

pnpm install @fleek-platform/next

Usage

To build and prepare your Next.js application for deployment on Fleek, follow these steps:

1. Configure Edge Runtime Add the following code to any routes that run server-side code to ensure they run on the edge:

export const runtime = 'edge';

2. Build

Use the Fleek Next.js adapter to build and deploy your application via the command line:

npx fleek-next build
# or if installed globally
fleek-next build

If you are running the command outside of your project's root dir, you can set the path to it with the project path flag -p/--projectPath:

fleek-next build -p path/to/my/repo

The build command supports several options to customize the build and deployment process:

• -p, --project-path <path>: The path to your Next.js project's root directory. Defaults to the path where the command is run.
• -s, --skipBuild: Skip building the Next.js app before deployment, useful if you want to build the application yourself due to any possible extra steps. Defaults to false.
• -i, --skipInstallation: Skip installing the dependencies. Defaults to false.
• -c, --clean: Clean previous build artifacts before building.
• -v, --verbose: Enable verbose logging.

3. Deploy your function:

Use the Fleek CLI to deploy your function:

fleek functions deploy --noBundle --name '<name of your function>' --path .fleek/dist/index.js

Release Process

This project follows SemVer for versioning. Here's how to release a new version:

1. Update Version Number: Bump the version number in package.json using npm version (patch/minor/major). This will update the version number in package.json and create a new Git tag.

pnpm version patch

2. Push Changes and Tags

git push origin main --follow-tags

3. GitHub Actions Automation: A GitHub Actions workflow automatically publishes the package to npm when a new tag is pushed.

Contributing

Thanks for considering contributing to our project!

How to Contribute

1. Fork the repository.
2. Create a new branch: git checkout -b feature-branch-name.
3. Make your changes.
4. Commit your changes using conventional commits.
5. Push to your fork and submit a pull request.

Commit Guidelines

We use Conventional Commits for our commit messages:

• test: 💍 Adding missing tests
• feat: 🎸 A new feature
• fix: 🐛 A bug fix
• chore: 🤖 Build process or auxiliary tool changes
• docs: ✏️ Documentation only changes
• refactor: 💡 A code change that neither fixes a bug or adds a feature
• style: 💄 Markup, white-space, formatting, missing semi-colons...