Develop. Preview. Ship.
Documentation · Changelog · Templates · CLI
Vercel’s Frontend Cloud provides the developer experience and infrastructure to build, scale, and secure a faster, more personalized Web.
Get started by importing a project or using the Vercel CLI. Then, git push
to deploy.
For details on how to use Vercel, check out our documentation.
This project uses pnpm to install dependencies and run scripts.
You can use the dev
script to run local changes as if you were invoking Vercel CLI. For example, vercel deploy --cwd=/path/to/project
could be run with local changes with pnpm dev deploy --cwd=/path/to/project
.
When contributing to this repository, please first discuss the change you wish to make via GitHub Discussions with the owners of this repository before submitting a Pull Request.
Please read our Code of Conduct and follow it in all your interactions with the project.
This project is configured in a monorepo, where one repository contains multiple npm packages. Dependencies are installed and managed with pnpm
, not npm
CLI.
To get started, execute the following:
git clone https://github.com/vercel/vercel
cd vercel
corepack enable
pnpm install
pnpm build
pnpm lint
pnpm test-unit
Make sure all the tests pass before making changes.
You can use pnpm dev
from the cli
package to invoke Vercel CLI with local changes:
cd ./packages/cli
pnpm dev <cli-commands...>
See CLI Local Development for more details.
Once you are done with your changes (we even suggest doing it along the way), make sure all the tests still pass by running:
pnpm test-unit
from the root of the project.
If any test fails, make sure to fix it along with your changes. See Interpreting test errors for more information about how the tests are executed, especially the integration tests.
Once you are confident that your changes work properly, open a pull request on the main repository.
The pull request will be reviewed by the maintainers and the tests will be checked by our continuous integration platform.
There are 2 kinds of tests in this repository – Unit tests and Integration tests.
Unit tests are run locally with jest
and execute quickly because they are testing the smallest units of code.
Integration tests create deployments to your Vercel account using the test
project name. After each test is deployed, the probes
key is used to check if the response is the expected value. If the value doesn't match, you'll see a message explaining the difference. If the deployment failed to build, you'll see a more generic message like the following:
[Error: Fetched page https://test-8ashcdlew.vercel.app/root.js does not contain hello Root!. Instead it contains An error occurred with this application.
NO_STATUS_CODE_FRO Response headers:
cache-control=s-maxage=0
connection=close
content-type=text/plain; charset=utf-8
date=Wed, 19 Jun 2019 18:01:37 GMT
server=now
strict-transport-security=max-age=63072000
transfer-encoding=chunked
x-now-id=iad1:hgtzj-1560967297876-44ae12559f95
x-now-trace=iad1]
In such cases, you can visit the URL of the failed deployment and append /_logs
to see the build error. In the case above, that would be https://test-8ashcdlew.vercel.app/_logs
The logs of this deployment will contain the actual error which may help you to understand what went wrong.
While running the full integration suite locally is not recommended, it's sometimes useful to isolate a failing test by running it on your machine. To do so, you'll need to ensure you have the appropriate credentials sourced in your shell:
- Create an access token. Follow the insructions here https://vercel.com/docs/rest-api#creating-an-access-token. Ensure the token scope is for your personal account.
- Grab the team ID from the Vercel dashboard at
https://vercel.com/<MY-TEAM>/~/settings
. - Source these into your shell rc file:
echo 'export VERCEL_TOKEN=<MY-TOKEN> VERCEL_TEAM_ID=<MY-TEAM-ID>' >> ~/.zshrc
From there, you should be able to trigger an integration test. Choose one that's already isolated to check that things work:
cd packages/next
Run the test:
pnpm test test/fixtures/00-server-build/index.test.js
Some of the Builders use @vercel/nft
to tree-shake files before deployment. If you suspect an error with this tree-shaking mechanism, you can create the following script in your project:
const { nodeFileTrace } = require('@vercel/nft');
nodeFileTrace(['path/to/entrypoint.js'], {
ts: true,
mixedModules: true,
})
.then(o => console.log(o.fileList))
.then(e => console.error(e));
When you run this script, you'll see all the imported files. If files are missing, the bug is in @vercel/nft and not the Builder.
Sometimes you want to test changes to a Builder against an existing project, maybe with vercel dev
or actual deployment. You can avoid publishing every Builder change to npm by uploading the Builder as a tarball.
- Change directory to the desired Builder
cd ./packages/node
- Run
pnpm build
to compile typescript and other build steps - Run
npm pack
to create a tarball file - Run
vercel *.tgz
to upload the tarball file and get a URL - Edit any existing
vercel.json
project and replaceuse
with the URL - Run
vercel
orvercel dev
to deploy with the experimental Builder
ai-sdk-rag-starter's People
Forkers
sukiyasuyuki rongzhang alitasofficial homeidjsc evertt taigokuriyama roeean hirotoshioi nicomoli ap-ucoders bhaveshkys aaayoungman tundakk nwaniayo raji2004 multipolarityai devinjelliot ignaciopardo fvenancio luquish ruozzy66 thesanimoney un3trois7 dyl-young-mohara mikesmallhelp royashoot polfunus harukats ewujain wdzierson ritavdasai-sdk-rag-starter's Issues
postgres migration error
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.