Zero-config frontend framework with automatic routing and optimization
npm install fluent-vxvx init and start coding
src/pages/ become routes
.vx files with familiar syntax
bash
Create a new Fluent VX project
npx vx create my-app
cd my-app
Install dependencies
npm install
Start development server
npm run dev
`
$3
`bash
Initialize in current directory
npx vx init
Install dependencies
npm install
Start development server
npm run dev
`
That's it! Your app is running at http://localhost:5172
š Project Structure
`
my-app/
āāā src/
ā āāā app.vx # Main application layout
ā āāā pages/ # File-based routing
ā ā āāā index.vx # Home page (/)
ā ā āāā about.vx # About page (/about)
ā āāā styles/
ā āāā global.css # Global styles
āāā fluent-vx.config.ts # Configuration (optional)
āāā package.json
āāā README.md
`
šØ Template Syntax
Fluent VX uses a simple, reactive template syntax:
`vx
// pages/index.vx
#data
title = "Hello World"
count = 0
items = ["Item 1", "Item 2", "Item 3"]
#end data
#view
{{ title }}
Count: {{ count }}
@for(item in items)
- {{ item }}
@end for
@if(count > 5)
Count is high!
@end if
#end view
#style
.container {
max-width: 800px;
margin: 0 auto;
padding: 2rem;
}
#end style
`
š£ļø Routing
Routes are automatically created from files in src/pages/:
`
src/pages/
āāā index.vx ā /
āāā about.vx ā /about
āāā blog.vx ā /blog
āāā blog/
ā āāā index.vx ā /blog
ā āāā [id].vx ā /blog/:id
āāā [...slug].vx ā /blog/*
`
š§ CLI Commands
`bash
Create new project
vx create
Initialize in current directory
vx init
Start development server
vx dev
Build for production
vx build
Preview production build
vx preview
Add integration
vx add
Remove integration
vx remove
Verify and fix integrations
vx iv
`
š Integrations
Fluent VX supports integrations for enhanced functionality:
`bash
Add Tailwind CSS
vx add tailwind
Add MDX support
vx add mdx
Add sitemap generation
vx add sitemap
`
š¤ Contributing
We welcome contributions! Please see our Contributing Guide for details.
1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature`)