🚀 Rapid Project Files (Rapid Console)

Rapid Project Files (codename Rapid Console) is a Visual Studio Code extension designed to help you create entire project structures, templates, and boilerplate files instantly — all from a single input box.

You can:

Create multiple folders and files in one go.
Define reusable project templates.
Store and substitute variables inside file contents.
Reuse everything across sessions — all data is stored globally.

✨ Features

Rapid Console Command (rapid:console)
- A single command that understands what you mean.
- Automatically detects if your input is:
  - A variable definition.
  - A reusable template.
  - A script that builds folders and files.
Variables
- Define text snippets or keywords for reuse.
- Use them inside your templates or file contents with $(variableName).
Templates
- Save entire project structures and recall them instantly.
Persistent Storage
- All variables and templates are saved globally — you never lose them between sessions.

✨ Quick Start

1. Run the Console

Right-click any folder in the VS Code Explorer, or open the command palette (Ctrl+Shift+P or Cmd+Shift+P), and run:

Rapid: Console

You’ll see an input box. This is your creative space — enter anything from variable assignments to full project definitions.

🧩 Core Syntax

📦 Create Files and Folders

A simple example:

index.html, style.css, /src/, /src/main.js

Creates:

index.html
style.css
/src/
└── main.js

🧠 Insert Text into Files

Use < followed by text or variable expressions:

index.html < "<h1>Hello World</h1>"

Creates index.html and fills it with that content.

You can also use arrays inside brackets [ ... ] to concatenate text segments:

index.html < ["<html>", "<body>", "<h1>$(title)</h1>", "</body>", "</html>"]

🧬 Variables

Define variables globally. They’re stored permanently until overwritten.

Define a variable:

$(title) = "Rapid Project Files"

Use it inside text:

index.html < "Welcome to $(title)"

Resulting file content:

Welcome to Rapid Project Files

Variables are replaced one-pass only — no recursive substitution for safety.

🧰 Templates

Templates are reusable project definitions — save once, reuse everywhere.

Save a template:

@webapp: /src/ < [index.html < "<h1>$(title)</h1>", /css/style.css, /js/app.js]

Run a saved template:

!webapp

Result:

/src/
├── index.html
├── css/
│   └── style.css
└── js/
    └── app.js

If you’ve previously set:

$(title) = "My Awesome App"

then index.html will contain:

<h1>My Awesome App</h1>

🧪 Advanced Examples

1. Nested Folder Creation

/project/ < [
  /src/ < [index.js < "console.log('Hello $(greeting)')"],
  /assets/images/,
  README.md < "# $(title)"
]

With:

$(greeting) = "World"
$(title) = "Rapid Example"

Creates:

/project/
├── src/
│   └── index.js   (console.log('Hello World'))
├── assets/
│   └── images/
└── README.md      (# Rapid Example)

2. Quick Boilerplate Starter

@nodeapp: / < [package.json < "{ \"name\": \"$(appname)\", \"version\": \"1.0.0\" }", index.js < "console.log('Welcome to $(appname)')"]

Store:

$(appname) = "MyNodeApp"

Run:

!nodeapp

Creates a simple Node.js starter setup.

3. Component Generator

@component: /components/ < [
  $(name).js < "export default function $(name)() { return '<div>$(name)</div>'; }",
  $(name).css < ".$(name) { color: red; }"
]

To generate a component:

$(name) = "Button"
!component

Output:

/components/
├── Button.js
└── Button.css

⚙️ Configuration and Storage

Rapid Project Files uses VS Code global storage to persist data.

Item	Location	Description
Variables	Global Storage	Stored as JSON under `rapid.variables`
Templates	Global Storage	Stored as JSON under `rapid.templates`

They survive between restarts and are user-wide.

🧩 Supported Commands

Command	Description
`$(name) = "value"`	Define a global variable
`@templateName: script`	Save a project template
`!templateName`	Execute a saved template
(any script)	Parse and execute as file/folder creation script

🛠 Tips and Tricks

Define variables before creating projects to reuse them in multiple templates.
Combine static text and variables inside arrays for clean multi-line insertions.
Folder paths always end with / — otherwise it’s treated as a file.
The < operator tells the parser: “insert something inside this file or folder.”
Arrays [ ... ] let you group multiple actions inside one context (file or folder).
Stored variables and templates can be viewed or reset using VS Code’s Developer: Open Extensions Storage.

💡 Example Workflows

One-liner website generator:

$(title) = "Super Site"
@web: /site/ < [
  index.html < ["<html><head><title>$(title)</title></head><body><h1>$(title)</h1></body></html>"],
  /css/style.css < "body { font-family: sans-serif; }",
  /js/main.js < "console.log('Loaded $(title)');"
]
!web

Minimal Python project:

@pyproj: / < [main.py < "print('Hello $(projectname)')", requirements.txt < "flask==2.0.0"]
$(projectname) = "FlaskDemo"
!pyproj

🧠 Why It’s Useful

Stop boilerplate burnout: define your project once and spawn it in seconds.
Ideal for prototyping: web, Python, Node.js, or any structure-based setup.
No clutter, no configuration: works directly through one console.
Great for teaching: helps new developers understand structure hierarchies.

💬 Example Scenarios

Frontend Developer:

“I type !reactapp and my React skeleton with folders, components, and configs just appears.”

Backend Developer:

“I save my Node or Flask project setup as a template and create new projects instantly.”

Educator:

“I can teach folder structure and templating logic without touching the terminal.”

📄 License

🧑‍💻 Author

Rapid Project Files by [Your Name]
Created with ❤️ to make VS Code automation truly rapid.

🧩 Version Highlights

Version	Features
1.0.0	Initial release with parser, executor, and storage system
1.1.0	Added variable support and persistent templates
1.2.0	Introduced Rapid Console unified input
1.3.0	New parser with proper bracket and quote handling

💎 Feedback & Contributions

Ideas? Bug reports? Template suggestions?
Submit them on GitHub or message your fellow developers.
Let’s make coding setups instantaneous.

Rapid Project Files

codequest