Static folder configuration in Flask - Step-by-Step Execution

Concept Flow - Static folder configuration

Start Flask App

↓

Set static_folder path

↓

Request for static file

↓

Check file in static_folder

Yes No↓

Serve file

↓

End request

This flow shows how Flask uses the static folder path to serve static files when requested.

Execution Sample

Flask

from flask import Flask
app = Flask(__name__, static_folder='assets')

@app.route('/')
def home():
    return 'Hello World!'

This code sets the static folder to 'assets' and defines a simple home route.

Execution Table

Step	Action	Static Folder Path	Request URL	File Found?	Response
1	Start Flask app	assets	-	-	App running
2	Request '/'	assets	/	N/A	Return 'Hello World!'
3	Request '/style.css'	assets	/style.css	Yes	Serve 'assets/style.css' file
4	Request '/image.png'	assets	/image.png	No	Return 404 Not Found

💡 Requests end after serving file or returning 404 if file not found in static folder

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4
static_folder	assets	assets	assets	assets
request_url	-	/	/style.css	/image.png
file_found	-	N/A	Yes	No
response	-	'Hello World!'	File content	404 Not Found

Key Moments - 2 Insights

Why does Flask look in the 'assets' folder for static files?

Because the static_folder parameter was set to 'assets' when creating the Flask app, as shown in execution_table step 1.

What happens if a requested static file is not found?

Flask returns a 404 Not Found response, as seen in execution_table step 4.

Visual Quiz - 3 Questions

Look at the execution_table, what is the static_folder path after starting the app?

A static

B assets

C public

D templates

💡 Hint

Check the 'Static Folder Path' column at Step 1 in execution_table

At which step does Flask serve a static file successfully?

A Step 3

B Step 4

C Step 2

D Step 1

💡 Hint

Look for 'Serve file' or 'File Found?' = Yes in execution_table

If the static_folder was not set, where would Flask look for static files by default?

A assets

B templates

C static

D public

💡 Hint

Recall Flask's default static folder name if not configured

Concept Snapshot

Flask static folder configuration:
- Set static folder with Flask(__name__, static_folder='folder_name')
- Flask serves files from this folder on static requests
- If file not found, returns 404
- Default static folder is 'static' if not set
- Use URL like '/filename.ext' to access static files

Full Transcript

This visual execution shows how Flask handles static folder configuration. When creating the Flask app, you can set the static folder path using the static_folder parameter. Flask then looks in this folder to serve static files like CSS or images when requested by URL. If the file exists, Flask serves it; otherwise, it returns a 404 error. By default, if you don't set static_folder, Flask uses a folder named 'static'. This flow helps beginners understand how Flask connects URL requests to files on disk in the static folder.

Practice

1. What is the default folder name Flask uses to serve static files like images and CSS?

easy

A. assets

B. static

C. public

D. files

Solution

1. Step 1: Recall Flask default static folder

   Flask by default looks for a folder named static in your project to serve static files.

2. Step 2: Confirm other options are not defaults

   Folders like assets, public, or files are common in other frameworks but not Flask's default.

3. Final Answer:

   static -> Option B

4. Quick Check:

   Default static folder = static [OK]

Hint: Remember Flask uses 'static' folder by default for static files [OK]

Common Mistakes:

• Confusing 'assets' or 'public' as default static folder
• Thinking Flask serves static files from root directory
• Assuming no default static folder exists

2. Which of the following is the correct way to change the static folder name to 'assets' when creating a Flask app?

easy

A. app = Flask(__name__, static='assets')

B. app = Flask(static_folder='assets')

C. app = Flask(__name__, static_folder='assets')

D. app = Flask(__name__, static_url_path='assets')

Solution

1. Step 1: Identify correct Flask constructor parameter

   The parameter to change the static folder name is static_folder, used as Flask(__name__, static_folder='assets').

2. Step 2: Check other options for errors

   static='assets' is invalid, missing __name__ is wrong, and static_url_path changes URL path, not folder name.

3. Final Answer:

   app = Flask(__name__, static_folder='assets') -> Option C

4. Quick Check:

   Change folder with static_folder param [OK]

Hint: Use static_folder param in Flask constructor to rename folder [OK]

Common Mistakes:

• Using static instead of static_folder
• Omitting __name__ argument
• Confusing static_url_path with static_folder

3. Given this Flask app code:

app = Flask(__name__, static_folder='assets', static_url_path='/content')

# Assume assets folder contains image.png

# What URL path serves image.png?

medium

A. /content/image.png

B. /assets/image.png

C. /static/image.png

D. /image.png

Solution

1. Step 1: Understand static_folder and static_url_path roles

   static_folder='assets' sets the folder name, static_url_path='/content' sets the URL prefix to access static files.

2. Step 2: Determine URL to access image.png

   Since URL path is set to /content, the image is served at /content/image.png.

3. Final Answer:

   /content/image.png -> Option A

4. Quick Check:

   URL path = static_url_path value [OK]

Hint: URL uses static_url_path, not static_folder name [OK]

Common Mistakes:

• Assuming URL matches folder name
• Using default /static URL path despite override
• Confusing folder name with URL path

4. What is wrong with this Flask app code if static files are not served correctly?

app = Flask(__name__, static_folder='staticfiles')

# staticfiles folder exists with CSS files

# Trying to access /static/style.css returns 404

medium

A. The URL path /static does not match the static_folder name 'staticfiles'

B. The static_folder parameter should be set to 'static', not 'staticfiles'

C. The static_url_path should be set to '/staticfiles' to match folder name

D. Flask does not serve static files automatically

Solution

1. Step 1: Check static_folder and URL path mismatch

   Flask serves static files at URL path /static by default, but folder is renamed to staticfiles.

2. Step 2: Understand URL path must match static_url_path

   Since static_url_path is not set, Flask expects files at /static URL but folder is staticfiles, causing 404.

3. Final Answer:

   The URL path /static does not match the static_folder name 'staticfiles' -> Option A

4. Quick Check:

   URL path must match static_folder or static_url_path [OK]

Hint: Match static_url_path with static_folder or set both explicitly [OK]

Common Mistakes:

• Assuming folder rename auto-updates URL path
• Not setting static_url_path when changing folder
• Believing Flask never serves static files automatically

5. You want to serve static files from a folder named 'public_assets' but keep the URL path as '/static'. Which Flask app configuration achieves this?

hard

A. app = Flask(__name__, static_url_path='/static')

B. app = Flask(__name__, static_folder='static', static_url_path='/public_assets')

C. app = Flask(__name__, static_folder='public_assets')

D. app = Flask(__name__, static_folder='public_assets', static_url_path='/static')

Solution

1. Step 1: Set static_folder to 'public_assets'

   To serve files from 'public_assets' folder, set static_folder='public_assets'.

2. Step 2: Keep URL path as '/static'

   Set static_url_path='/static' to keep URL path unchanged.

3. Step 3: Verify other options

   app = Flask(__name__, static_folder='static', static_url_path='/public_assets') swaps folder and URL path, C uses default URL path '/static', D misses folder setting.

4. Final Answer:

   app = Flask(__name__, static_folder='public_assets', static_url_path='/static') -> Option D

5. Quick Check:

   Folder and URL path set explicitly [OK]

Hint: Set static_folder and static_url_path explicitly to control folder and URL [OK]

Common Mistakes:

• Swapping folder and URL path values
• Not setting static_url_path when folder changes
• Assuming default URL path changes with folder