Update netlify-feature-tour for example purposes.

TL;DR

Serverless functions may not run in netlify dev mode without additional setup not currently specified in the feature tour docs.

Details

👋 Howdy, Netlify friends!

I just went through this repo in preparation for a chat with the Netlify dev team tomorrow and got a bit stuck with the Create Your First Serverless Function section of the demo. Specifically, I was able to deploy and get a serverless function running in production but not locally (i.e. using netlify dev on my machine).

Unless I'm missing something (definitely possible, given my rusty JS chops!), it seems like these instructions on the Netlify Functions page may need a bit of tweaking:

Save it, then run netlify dev to test locally.
Check your work by clicking the button below!

When I create the function and run netlify dev on my machine as instructed, then click Test Your Function, I get the following error:

In the local server logs, I'm seeing:

◈ Starting Netlify Dev with Astro

> @example/[email protected] dev
> astro dev

[19:29:41] [snowpack] Hint: run "snowpack init" to create a project config file. Using defaults...
[19:29:41] [snowpack] Ready!
[19:29:41] [snowpack] watching for file changes... 
[dev server] Server started in 383ms.
[dev server] Local: http://localhost:3000/
[access] /.netlify/functions/hello-world
[access] /404
[access] Not Found: /.netlify/functions/hello-world
⠼ Waiting for framework port 3000. This can be configured using the 'targetPort' property in the netlify.toml

curl-ing the function endpoint directly doesn't seem to be working either:

$ curl localhost:3000/.netlify/functions/hello-world
Not Found%    

I played around with different filenames and paths for a bit before deciding to deploy to production to see if I could break my site there. However, to my surprise, the exact same code worked in prod:

Unlike in dev, in production, curl-ing the function endpoint works as expected:

$ curl https://MY-SUBDOMAIN.netlify.app/.netlify/functions/hello-world
hello world!%

In case it helps, here's a screenshot of the function I wrote (simple copy-pasta from the instructions) as well as its location within my project:

I'm guessing that there must be some additional setup needed to spark the /.netlify path magic and get functions running locally. It could be great if you could update the repo to include instructions on how to do that - or at least remove the suggestion to try running functions locally so anxious candidates like me don't tear more hair out than necessary 😅

This is an issue generated by (for-internal-use-only)github-tools

Description

This repository has exceeded the development grace period, and the repo owner must decide if branch protections should be enforced.
If this repository houses code used in production in any capacity, branch protections must be enforced. Read (for-internal-use-only)here for more details

What do I need to do?

• You can control whether or not branch protections are enforced by exclusively creating either of the labels:
  'enforce-branch-protections: true' or 'enforce-branch-protections: false'
• If there is no branch protection control label, this issue will be recreated.
• Once you have created either label, you can close this issue.
• If you have issues or questions, please reach out to #internal-security-n-compliance on slack.