GETTING STARTED

Rasengan.js Project Structure

Welcome! This guide will walk you through the structure of a Rasengan.js project, explaining its core directories, essential files, and conventions. By understanding this structure, you’ll be able to navigate and organize your project with ease.

Top-Level Directories

A Rasengan.js project follows a simple yet powerful structure. At the root of your project, you'll find these key directories:

DirectoryDescription
publicStores static assets such as images, icons, and fonts.
srcContains all the source code for your application.

Top-Level Files

Alongside the main directories, a Rasengan.js project includes important configuration and environment files:

FileDescription
rasengan.config.jsThe main configuration file for your project.
package.jsonManages dependencies, scripts, and project metadata.
.envStores environment variables.
.env.exampleProvides a template for environment variables.
.gitignoreSpecifies files and folders to be ignored by Git.
README.mdDocumentation for your project.
rasengan-env.d.tsTypeScript declarations for Rasengan.js.
tsconfig.jsonConfiguration file for TypeScript projects.
jsconfig.jsonConfiguration file for JavaScript projects.

Inside the src Folder

The src directory is the heart of your project, where you’ll define your application's logic, components, and pages.

Subdirectories

DirectoryDescriptionRequirement
appHolds all the pages of your project.Required
componentsStores reusable UI components.Optional
assetsContains images, fonts, and other static assets.Optional

Essential Files

FileExtensionsDescriptionRequirement
main.jsx .tsxThe main file that renders your app.Required
template.jsx .tsxDefines the HTML structure of your app.Required
index.js .tsThe entry point of your application.Required

The app Folder

The app folder is where your pages, routers, and layouts live. It organizes the structure of your application, ensuring smooth navigation and rendering.

InfoThe app folder is required for your project to function properly.

File Types in app

File TypeExtensionsPurposeExample
[name].page.js .jsx .ts .tsx .md .mdxDefines a page.home.page
[name].router.js .tsManages routing logic.app.router
[name].layout.js .jsx .ts .tsxCreates a shared layout structure.app.layout

With this structured approach, Rasengan.js keeps your project clean, scalable, and easy to manage. Now you’re ready to start building with confidence! 🚀

Installation
Routing - Base Concepts

Subscribe to the Newsletter

Stay informed to the news about rasengan.js including new releases, events, etc...

© 2025 Rasengan Labs, All rights reserved.