Skip to content

aleksa-codes/portal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

53 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŒ€ Portal

Infinite Interdimensional Web Router inspired by Rick and Morty's portal gun.

Portal (formerly GPT FileSmith) allows you to enter any path or URL (e.g., /plumbus.html, /blips-and-chitz/arcade.js), and a powerful AI Core will generate a corresponding file based on the path and extension.

Astro Tailwind CSS TypeScript Netlify

Features

  • Dimensional Tethering 🌌 Enter any path (e.g., /about.html, /styles.css), and the selected AI Model synthesizes file content based on the path.
  • Multiverse Core Integration πŸ”‹ Slap your API keys into the Battery Bay to power the portal gun with gpt-5.4-nano, gemini-3.1-flash-lite, or claude-4.5-haiku.
  • Secure Authentication πŸ”’ Keys are never saved to a database, just stored in your local HTTP-only secure cookies!
  • Rick & Morty Action Bar πŸ”« Wrap generated HTML in a sleek interdimensional action bar allowing instant extraction (downloads) or portal closing.
  • Direct Address Bar Execution ⚑ Just type /anything.html directly in the browser's address bar to skip the gadget UI and simulate instantly.

Quick Start

# Clone & install
git clone https://github.com/aleksa-codes/portal.git
cd portal
bun install

# Run dev server
bun run dev

Open http://localhost:3000.

Scripts

Command Description
bun run dev Dev server (port 3000)
bun run build Build for production (Astro + Netlify Edge)
bun run preview Preview production build
bun run format Prettier (Astro + Tailwind + import sorting)

Project Structure

src/
β”œβ”€β”€ layouts/           # layout.astro (HTML boilerplate, fonts, global styles)
β”œβ”€β”€ pages/             # Routes
β”‚   β”œβ”€β”€ index.astro    # Frontend "Gadget Console" view
β”‚   β”œβ”€β”€ [...path].ts   # Catch-all dynamic route for file generation
β”‚   └── api/           # ReST API storing/wiping user API Keys
β”œβ”€β”€ styles/            # global.css (Theming, animations, R&M UI gradients)
└── utils/             # ai-provider.ts (Vercel AI wrapper for LLMs)

Tech Stack

Category Technology
Framework Astro 6
Styling Tailwind CSS 4 + PostCSS Context
AI SDK Vercel AI SDK
AI Models OpenAI, Google Generative AI, Anthropic
Deployment Netlify (Edge Adapters)
Package Manager Bun
Icons astro-icon (@iconify-json/lucide)

Deployment

Deploy to Netlify with these settings:

  • Build command: bun run build
  • Publish directory: dist
  • Framework: Astro

License

MIT - see LICENSE.

About

πŸŒ€ An interdimensional file generator inspired by Rick & Morty's portal gun. Enter any path to generate customized files via the Vercel AI SDK (OpenAI, Gemini, & Claude).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors