[Youtube Video] Tizen TV Project Folder Structure

Getting your Tizen TV project organized the right way from the start saves you debugging headaches down the road. Here is the folder structure that experienced Samsung Smart TV developers rely on — whether you are writing plain HTML/CSS/JS or using a modern React or Vue SPA.

The Mandatory Starting Point: config.xml

No matter what structure you choose, one file is non-negotiable: config.xml must live at the root of your Tizen project. It is the control file that tells the Tizen runtime how to launch your app, what privileges it needs, and where to find your entry HTML file. Alongside it, your index.html (the app entry point) also lives at the root level.

The Classic Layout for Smaller Apps

Most small-to-medium Tizen apps follow the official template structure:

• css/ — stylesheets
• js/ — application logic
• lib/ — third-party scripts and libraries
• res/ — images, fonts, and other static assets

This clean, flat structure keeps everything predictable and maps well to how Tizen resolves paths inside the packaged app.

The Modern Framework Approach (React / Vue)

Larger apps benefit from a different pattern: build your application as a standard React or Vue SPA, then copy the production build output into a thin Tizen wrapper directory that contains config.xml and nothing else app-specific. The wrapper is what gets packaged into the .wgt file for deployment to the TV.

This separation keeps your modern frontend tooling fully intact while still satisfying Tizen’s packaging requirements.

Four Rules Every Tizen App Must Follow

1. config.xml must be at the wrapper root
2. The content src attribute in config.xml must point to index.html
3. TV-specific privileges (like internet access or remote control) must be declared in config.xml
4. All asset paths should be root-relative to avoid packaging issues

Why Structure Matters for TV Performance

Samsung Smart TVs have constrained hardware compared to desktop browsers. A predictable, well-organized project structure reduces load times, makes asset resolution faster, and simplifies the packaging and submission process through Tizen Studio.

Watch the full video to see these concepts broken down visually in under a minute — it is the quickest way to internalize the structure pros use every day.